Overview
POST/processing/jobsprocessing

Enqueue an ad-hoc job (management)

Ad-hoc / explicit enqueue path (task family 3). Requires a user JWT. The caller's ecosystemId becomes the owning ecosystem. Returns { id, deduped }.

Auth: bearerAuth — calls run as the authenticated user.

Request body

application/json · optional

  • jobTypestring

    Discriminator for worker routing (e.g. categorize_and_tag)

  • targetKindstring

    Namespace of the target entity (e.g. content.markdown)

  • targetIdstring

    UUID of the target entity

  • payloadany

    Arbitrary job-specific input stored as jsonb

  • priorityoptionalinteger

    Higher value = claimed first; defaults to 0

Example
{
  "jobType": "string",
  "targetKind": "string",
  "targetId": "string",
  "payload": {},
  "priority": 0
}
Responses
201

Job enqueued

  • idstring

    ID of the enqueued (or existing deduped) job

  • dedupedboolean

    True when an existing job with the same dedupKey was returned

Example
{
  "id": "string",
  "deduped": true
}
400

Error

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

Error

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