Skip to main content
POST
/
agents
/
{group}
/
{slug}
/
run
Run an agent
curl --request POST \
  --url https://api.mindcase.co/api/v1/agents/{group}/{slug}/run \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "params": {
    "usernames": [
      "mkbhd",
      "casey"
    ]
  }
}
'
{
  "job_id": "job_abc123def456",
  "agent": "instagram/profiles",
  "status": "queued",
  "created_at": "2026-03-31T10:15:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key in the format mk_live_...

Path Parameters

​
group
string
required
​
slug
string
required

Body

application/json
​
params
object
required
Example:
{ "usernames": ["mkbhd", "casey"] }

Response

Job queued successfully

​
job_id
string
required
Example:

"job_abc123def456"

​
agent
string
required
Example:

"instagram/profiles"

​
status
enum<string>
required
Available options:
queued
Example:

"queued"

​
created_at
string<date-time>
required
Example:

"2026-03-31T10:15:00Z"