> ## 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. # Complete Reporter Upload > Finalize an upload: validate the wasm blob against its declared attributes and record an immutable version against an already-registered reporter. The reporter must exist (register it first, POST /reporters/register) — upload only submits versions, it never creates identities. ## OpenAPI ````yaml https://softmax.com/api/observatory/openapi.json post /v2/reporters/upload/complete 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/upload/complete: post: tags: - v2 - v2 summary: Complete Reporter Upload description: |- Finalize an upload: validate the wasm blob against its declared attributes and record an immutable version against an already-registered reporter. The reporter must exist (register it first, POST /reporters/register) — upload only submits versions, it never creates identities. operationId: complete_reporter_upload_v2_reporters_upload_complete_post requestBody: content: application/json: schema: $ref: '#/components/schemas/ReporterUploadCompleteRequest' required: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ReporterUploadCompleteResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - BearerAuth: [] components: schemas: ReporterUploadCompleteRequest: properties: name: type: string maxLength: 200 minLength: 1 pattern: ^[a-z0-9][a-z0-9_.-]*$ title: Name content_hash: type: string pattern: ^[0-9a-f]{64}$ title: Content Hash attributes: $ref: '#/components/schemas/ReporterVersionAttributes' player_id: anyOf: - type: string pattern: >- ^ply_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ - type: 'null' title: Player Id additionalProperties: false type: object required: - name - content_hash - attributes title: ReporterUploadCompleteRequest ReporterUploadCompleteResponse: properties: version: $ref: '#/components/schemas/ReporterVersionPublic' type: object required: - version title: ReporterUploadCompleteResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ReporterVersionAttributes: properties: purpose: type: string maxLength: 200 minLength: 1 title: Purpose world: type: string enum: - softmax:reporter@0.1.0 - softmax:reporter@0.2.0 - softmax:reporter@0.2.1 - softmax:reporter@0.3.0 - softmax:reporter@0.4.0 title: World execution: type: string enum: - parallel - serial title: Execution default: parallel outputs: items: $ref: '#/components/schemas/OutputDecl' type: array maxItems: 50 minItems: 1 title: Outputs requested_limits: $ref: '#/components/schemas/ReporterLimits' additionalProperties: false type: object required: - purpose - world - outputs title: ReporterVersionAttributes description: The full declared contract carried on a reporter version row. ReporterVersionPublic: properties: id: type: string title: Id reporter_id: type: string title: Reporter Id name: type: string title: Name version: type: integer title: Version content_hash: type: string title: Content Hash size_bytes: type: integer title: Size Bytes world: type: string title: World attributes: additionalProperties: true type: object title: Attributes granted_limits: additionalProperties: true type: object title: Granted Limits player_id: anyOf: - type: string - type: 'null' title: Player Id created_at: type: string format: date-time title: Created At type: object required: - id - reporter_id - name - version - content_hash - size_bytes - world - attributes - granted_limits - player_id - created_at title: ReporterVersionPublic 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 OutputDecl: properties: name: type: string maxLength: 100 minLength: 1 pattern: ^[a-z0-9][a-z0-9_-]*$ title: Name type: type: string enum: - render-html - render-markdown - event-log - json - file title: Type description: type: string maxLength: 2000 minLength: 1 title: Description schema: anyOf: - type: string - type: 'null' title: Schema optional: type: boolean title: Optional default: false additionalProperties: false type: object required: - name - type - description title: OutputDecl description: 'One declared output part: name, catalog type, and semantic meaning.' ReporterLimits: properties: memory_mib: type: integer exclusiveMinimum: 0 title: Memory Mib default: 512 guest_cpu_seconds: type: integer exclusiveMinimum: 0 title: Guest Cpu Seconds default: 120 wall_clock_seconds: type: integer exclusiveMinimum: 0 title: Wall Clock Seconds default: 900 scratch_mib: type: integer exclusiveMinimum: 0 title: Scratch Mib default: 1024 tool_calls: type: integer exclusiveMinimum: 0 title: Tool Calls default: 2000 llm_usd: type: number exclusiveMinimum: 0 title: Llm Usd default: 2 artifact_read_mib: type: integer exclusiveMinimum: 0 title: Artifact Read Mib default: 2048 output_mib: type: integer exclusiveMinimum: 0 title: Output Mib default: 256 additionalProperties: false type: object title: ReporterLimits description: |- Sandbox limits for one run. Fields default to the platform defaults; a version's requested_limits overrides them within HARD_CEILINGS. securitySchemes: BearerAuth: type: http scheme: bearer description: Bearer token issued by Softmax ````