Skip to main content
POST
/
api
/
jobs
/
trigger
Trigger an execution for all project queries
curl --request POST \
  --url https://api.mentionlab.io/api/jobs/trigger \
  --header 'Content-Type: application/json' \
  --header 'x-project-id: <x-project-id>' \
  --data '
{
  "aiModels": [
    "gpt-4.1-mini",
    "claude-haiku-4-5",
    "gemini-2.5-flash"
  ],
  "executionCount": 3
}
'
{
  "id": "01234567-89ab-cdef-0123-456789abcdef",
  "project": "01234567-89ab-cdef-0123-456789abcdef",
  "totalExecutions": 100,
  "pendingExecutions": 10,
  "retryingExecutions": 2,
  "successExecutions": 80,
  "failedExecutions": 8,
  "status": "processing",
  "createdAt": "2026-06-08T12:00:00.000Z",
  "updatedAt": "2026-06-08T12:30:00.000Z",
  "createdBy": {
    "firstName": "Jane",
    "lastName": "Doe",
    "email": "jane.doe@example.com",
    "id": "01234567-89ab-cdef-0123-456789abcdef"
  }
}

Headers

​
x-project-id
string
required

Project ID to specify the project context

Body

application/json
​
aiModels
enum<string>[]
required

List of AI model identifiers to use for analysis

Available options:
gpt-4.1-mini,
gpt-5-mini,
gpt-5-chat-latest,
gpt-5.1-chat-latest,
gpt-5.2-chat-latest,
gpt-5.3-chat-latest,
chat-latest,
claude-haiku-4-5,
gemini-2.5-flash,
gemini-3-flash-preview,
sonar,
deepseek-v3.2-maas,
ai-overview,
ai-mode,
scp-ml-chatgpt,
scp-ml-google-ai-mode,
scp-ml-gemini
Example:
[
  "gpt-4.1-mini",
  "claude-haiku-4-5",
  "gemini-2.5-flash"
]
​
executionCount
number
required

The number of executions (runs) per job item

Required range: x >= 1
Example:

3

Response

​
id
string<uuid>
required

Unique identifier of the job.

Example:

"01234567-89ab-cdef-0123-456789abcdef"

​
project
required

Project the job belongs to. Returned as the project identifier (UUID) when not populated, or as the full project object when expanded.

Example:

"01234567-89ab-cdef-0123-456789abcdef"

​
totalExecutions
number
required

Total number of executions associated with the job.

Example:

100

​
pendingExecutions
number
required

Number of executions that are still pending processing.

Example:

10

​
retryingExecutions
number
required

Number of executions currently being retried after a failure.

Example:

2

​
successExecutions
number
required

Number of executions that completed successfully.

Example:

80

​
failedExecutions
number
required

Number of executions that failed.

Example:

8

​
status
enum<string>
required

Overall status of the job, derived from the state of its executions.

Available options:
pending,
processing,
completed,
failed,
partial_failed
Example:

"processing"

​
createdAt
string<date-time>
required

Timestamp at which the job was created.

Example:

"2026-06-08T12:00:00.000Z"

​
updatedAt
string<date-time>
required

Timestamp at which the job was last updated.

Example:

"2026-06-08T12:30:00.000Z"

​
createdBy
object

User who created the job. May be null when the creator is unknown or no longer available.