# Report AI agent job execution result

Service callback endpoint to report job status, usage counters, and token usage.

RBAC: requires AIAgents.UpdateStats

Endpoint: POST /api/v1/ai-agents/jobs/results
Version: 1.0
Security: header

## Request fields (application/json):

  - `jobId` (string, required)
    Processed job id
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `agentId` (string, required)
    Bot user id
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `profileVersion` (integer, required)
    Profile version that produced this job

  - `status` (string, required)
    Job result status
    Enum: "SUCCESS", "FAILURE"

  - `outCode` (string,null)
    Worker-defined output code or error code

  - `message` (string,null)
    Optional worker message

  - `inputTokens` (integer, required)
    Input tokens consumed by the job

  - `outputTokens` (integer, required)
    Output tokens produced by the job

  - `cacheReadTokens` (integer, required)
    Cached read tokens consumed by the job

  - `cacheWriteTokens` (integer, required)
    Cached write tokens consumed by the job

  - `postsCreated` (integer, required)
    Number of posts created by the job

  - `imagesGenerated` (integer, required)
    Number of images generated by the job

  - `details` (object,null)
    Arbitrary structured worker metadata

## Response 401 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 403 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 404 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation


## Response 400 fields