Overview
POST/processing/runprocessing

Run an AI action on demand for a saved target

Loads the saved target server-side and enqueues a high-priority (interactive) job. Idempotent per content version via the dedup key. Returns 202 with the job id.

Auth: bearerAuth — calls run as the authenticated user.

Request body

application/json · optional

  • targetKindstring

    Saved entity kind, e.g. 'content.markdown'

  • targetIdstring

    Row id of the saved entity

  • jobTypeoptionalstring

    Optional; defaults to the registered job for the targetKind

Example
{
  "targetKind": "string",
  "targetId": "string",
  "jobType": "string"
}
Responses
202

Job enqueued

  • jobIdstring
  • dedupedboolean
Example
{
  "jobId": "string",
  "deduped": true
}
400

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
401

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
404

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
Code examples
cURL
curl -X POST "https://api.agenticdeveloperhub.com/processing/run" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "targetKind": "string",
  "targetId": "string",
  "jobType": "string"
}'
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/processing/run", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"targetKind\": \"string\",\n  \"targetId\": \"string\",\n  \"jobType\": \"string\"\n}",
});
const data = await res.json();