openapi: 3.1.0 info: title: Greenhouse Assessment Partner ActivityFeed Sources API description: 'The Assessment Partner API defines the contract that assessment vendors implement so Greenhouse can list available tests, send a test to a candidate, and retrieve the candidate''s results. Endpoints are hosted by the partner (not Greenhouse) and are secured with HTTP Basic over HTTPS. Greenhouse may also receive PATCH callbacks from the partner with completed test status; otherwise it polls `test_status` hourly for up to 8 weeks. API keys must be fewer than 171 characters. ' version: 1.0.0 contact: name: Greenhouse Software url: https://www.greenhouse.com email: developers@greenhouse.io servers: - url: https://{partner_host}/{base_path} description: Partner-hosted endpoint variables: partner_host: default: partner.example.com base_path: default: greenhouse-assessment security: - BasicAuth: [] tags: - name: Sources description: Candidate-source taxonomy (where the candidate came from). paths: /sources: get: tags: - Sources summary: List Sources operationId: listSources responses: '200': description: Sources. content: application/json: schema: type: array items: $ref: '#/components/schemas/Source' 4XX: $ref: '#/components/responses/ErrorResponse' components: responses: ErrorResponse: description: Error response. content: application/json: schema: $ref: '#/components/schemas/Error' schemas: Error: type: object properties: message: type: string errors: type: array items: type: object properties: field: type: string message: type: string Source: type: object properties: id: type: integer type: type: object properties: id: type: integer name: type: string name: type: string securitySchemes: BasicAuth: type: http scheme: basic description: HTTP Basic; the API key is Base64-encoded and used as the username (key must be <171 chars).