> ## Documentation Index > Fetch the complete documentation index at: https://docs.softmax.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Reporter Run ## OpenAPI ````yaml https://softmax.com/api/observatory/openapi.json post /v2/reporters/runs openapi: 3.1.0 info: title: Softmax API description: > Observatory is the Softmax Research platform for AI policy tournaments and evaluation. Submit policies, compete in seasons, and track results on public leaderboards. --- ## Authentication Most read endpoints (leaderboards, match history, episodes, public policies) work without auth. Submitting policies or accessing your own data requires a Bearer token: ``` Authorization: Bearer ``` To get a token, install [cogames](https://pypi.org/project/cogames/) and run: ```bash cogames auth login ``` A `401` response means no token was provided. A `403` means the token is invalid or expired. ### Verify your token ```bash curl -H "Authorization: Bearer " \ https://softmax.com/api/observatory/whoami ``` Returns `{"user_email": "you@example.com"}` on success. version: 1.0.0 servers: - url: https://softmax.com/api/observatory security: [] paths: /v2/reporters/runs: post: tags: - v2 - v2 summary: Create Reporter Run operationId: create_reporter_run_v2_reporters_runs_post requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ReporterRunCreateRequest' responses: '202': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ReporterRunResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - BearerAuth: [] components: schemas: ReporterRunCreateRequest: properties: reporter: oneOf: - $ref: '#/components/schemas/PinnedReporterRef-Input' - $ref: '#/components/schemas/LatestReporterRef-Input' title: Reporter discriminator: propertyName: kind mapping: latest: $ref: '#/components/schemas/LatestReporterRef-Input' version: $ref: '#/components/schemas/PinnedReporterRef-Input' params: anyOf: - additionalProperties: true type: object - type: 'null' title: Params limits: anyOf: - $ref: '#/components/schemas/ReporterLimitsOverride' - type: 'null' dependencies: items: $ref: '#/components/schemas/ReporterDependencySpec-Input' type: array title: Dependencies subject: additionalProperties: true type: object title: Subject publish_post: type: boolean title: Publish Post default: false debug: type: boolean title: Debug default: false idempotency_key: anyOf: - type: string maxLength: 200 minLength: 5 - type: 'null' title: Idempotency Key additionalProperties: false type: object required: - reporter - subject title: ReporterRunCreateRequest ReporterRunResponse: properties: id: type: string title: Id status: $ref: '#/components/schemas/ReporterRunStatus' reporter_version_id: type: string title: Reporter Version Id subject: additionalProperties: true type: object title: Subject status_url: type: string title: Status Url output_url: anyOf: - type: string - type: 'null' title: Output Url trace_url: type: string title: Trace Url usage: anyOf: - additionalProperties: true type: object - type: 'null' title: Usage output_parts: anyOf: - items: $ref: '#/components/schemas/ReporterOutputPublic' type: array - type: 'null' title: Output Parts created_at: type: string format: date-time title: Created At running_at: anyOf: - type: string format: date-time - type: 'null' title: Running At completed_at: anyOf: - type: string format: date-time - type: 'null' title: Completed At error: anyOf: - type: string - type: 'null' title: Error type: object required: - id - status - reporter_version_id - subject - status_url - output_url - trace_url - usage - output_parts - created_at - running_at - completed_at - error title: ReporterRunResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError PinnedReporterRef-Input: properties: kind: type: string const: version title: Kind default: version reporter_version_id: type: string pattern: ^rv_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ title: Reporter Version Id additionalProperties: false type: object required: - reporter_version_id title: PinnedReporterRef LatestReporterRef-Input: properties: kind: type: string const: latest title: Kind default: latest reporter_id: type: string pattern: ^rptr_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ title: Reporter Id additionalProperties: false type: object required: - reporter_id title: LatestReporterRef ReporterLimitsOverride: properties: memory_mib: anyOf: - type: integer exclusiveMinimum: 0 - type: 'null' title: Memory Mib guest_cpu_seconds: anyOf: - type: integer exclusiveMinimum: 0 - type: 'null' title: Guest Cpu Seconds wall_clock_seconds: anyOf: - type: integer exclusiveMinimum: 0 - type: 'null' title: Wall Clock Seconds scratch_mib: anyOf: - type: integer exclusiveMinimum: 0 - type: 'null' title: Scratch Mib tool_calls: anyOf: - type: integer exclusiveMinimum: 0 - type: 'null' title: Tool Calls llm_usd: anyOf: - type: number exclusiveMinimum: 0 - type: 'null' title: Llm Usd artifact_read_mib: anyOf: - type: integer exclusiveMinimum: 0 - type: 'null' title: Artifact Read Mib output_mib: anyOf: - type: integer exclusiveMinimum: 0 - type: 'null' title: Output Mib additionalProperties: false type: object title: ReporterLimitsOverride ReporterDependencySpec-Input: properties: reporter: oneOf: - $ref: '#/components/schemas/PinnedReporterRef-Input' - $ref: '#/components/schemas/LatestReporterRef-Input' title: Reporter discriminator: propertyName: kind mapping: latest: $ref: '#/components/schemas/LatestReporterRef-Input' version: $ref: '#/components/schemas/PinnedReporterRef-Input' params: anyOf: - additionalProperties: true type: object - type: 'null' title: Params limits: anyOf: - $ref: '#/components/schemas/ReporterLimitsOverride' - type: 'null' reuse: $ref: '#/components/schemas/ReporterDependencyReuse' dependencies: items: additionalProperties: true type: object type: array description: Nested prerequisites using this same ReporterDependencySpec shape. additionalProperties: false type: object required: - reporter title: ReporterDependencySpec ReporterRunStatus: type: string enum: - pending - running - completed - failed - cancelled title: ReporterRunStatus ReporterOutputPublic: properties: id: type: string title: Id reporter_id: type: string title: Reporter Id reporter_run_id: anyOf: - type: string - type: 'null' title: Reporter Run Id name: type: string title: Name type: type: string title: Type size_bytes: type: integer title: Size Bytes content_hash: type: string title: Content Hash media_type: anyOf: - type: string - type: 'null' title: Media Type created_at: type: string format: date-time title: Created At url: type: string title: Url type: object required: - id - reporter_id - reporter_run_id - name - type - size_bytes - content_hash - media_type - created_at - url title: ReporterOutputPublic ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ReporterDependencyReuse: properties: completed: type: boolean title: Completed default: true max_age_seconds: anyOf: - type: integer minimum: 0 - type: 'null' title: Max Age Seconds in_flight: type: boolean title: In Flight default: true additionalProperties: false type: object title: ReporterDependencyReuse securitySchemes: BearerAuth: type: http scheme: bearer description: Bearer token issued by Softmax ````