> ## Documentation Index > Fetch the complete documentation index at: https://docs.sorce.jobs/llms.txt > Use this file to discover all available pages before exploring further. # Publish a draft > DRAFT → ACTIVE. Runs the three publish gates: completeness (422 with a field map), terms accepted in the dashboard (409 AGREEMENT_OUTDATED), and a card on file (402). The listing runs for 30 days. ## OpenAPI ````yaml /openapi.yaml post /jobs/{id}/publish openapi: 3.1.0 info: title: Sorce API version: '1.0' description: > Programmatic job management for partners on Sorce. Authenticate with a company-bound partner key. All endpoints are served from https://www.sorce.jobs/api/external/v1. servers: - url: https://www.sorce.jobs/api/external/v1 security: - bearerAuth: [] tags: - name: Locations description: Canonical place lookup. Search first, reference by id. - name: Jobs description: > Partner job management. Requires a partner key bound to your company. Other companies' jobs 404. paths: /jobs/{id}/publish: post: tags: - Jobs summary: Publish a draft description: > DRAFT → ACTIVE. Runs the three publish gates: completeness (422 with a field map), terms accepted in the dashboard (409 AGREEMENT_OUTDATED), and a card on file (402). The listing runs for 30 days. operationId: publishJob parameters: - $ref: '#/components/parameters/jobId' responses: '200': description: The job, now ACTIVE. content: application/json: schema: $ref: '#/components/schemas/Job' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentMethodRequired' '404': $ref: '#/components/responses/NotFound' '409': $ref: '#/components/responses/AgreementOutdated' '422': $ref: '#/components/responses/ValidationFailed' components: parameters: jobId: name: id in: path required: true schema: type: integer description: The job's stable cross-service id (`svcAtsId`). schemas: Job: type: object description: The full job, as the dashboard sees it. properties: id: type: integer description: Stable cross-service job id (`svcAtsId`). title: type: string status: type: string enum: - DRAFT - ACTIVE - PAUSED - CLOSED - EXPIRED description: type: string remoteOption: type: - string - 'null' enum: - REMOTE - HYBRID - IN_PERSON - null remoteCountry: type: - string - 'null' jobType: type: - string - 'null' enum: - FULL_TIME - PART_TIME - CONTRACT - INTERNSHIP - null jobLevel: type: - string - 'null' enum: - ENTRY - MID - SENIOR - null salaryMin: type: - integer - 'null' salaryMax: type: - integer - 'null' salaryPeriod: type: - string - 'null' enum: - ANNUAL - HOURLY - null bidPerQualifiedApplicantCents: type: - integer - 'null' opportunityId: type: - string - 'null' description: Partner id for this opening on the source ATS. atsJobUrl: type: - string - 'null' format: uri description: Canonical job URL on the source ATS. companyId: type: string locations: type: array items: $ref: '#/components/schemas/LocationSuggestion' qualifications: type: array items: allOf: - $ref: '#/components/schemas/QualificationInput' - type: object properties: id: type: string questions: type: array items: allOf: - $ref: '#/components/schemas/QuestionInput' - type: object properties: id: type: string budgets: type: array items: $ref: '#/components/schemas/BudgetInput' applicationCounts: type: object properties: pending: type: integer accepted: type: integer rejected: type: integer isFrozen: type: boolean description: True once the job has applications. Qualifications/questions locked. newApplicantCount: type: integer publishedAt: type: - string - 'null' format: date-time expiresAt: type: - string - 'null' format: date-time closedAt: type: - string - 'null' format: date-time LocationSuggestion: type: object properties: locationId: type: integer example: 17024 displayName: type: string example: San Francisco, California, United States city: type: string example: San Francisco stateProvince: type: string example: California country: type: string example: United States QualificationInput: type: object required: - text - kind - order properties: text: type: string example: 5+ years of product design experience kind: type: string enum: - REQUIRED - DESIRED order: type: integer example: 0 QuestionInput: type: object description: > A custom screening question. Applicant basics (name, email, phone, location, resume) are collected automatically on every application and must not be sent as questions. required: - prompt - answerFormat - order properties: prompt: type: string example: Why do you want to work here? answerFormat: type: string enum: - TEXT - TEXTAREA - SINGLE_SELECT - MULTI_SELECT - NUMBER - FILE - DATE - SINGLE_CHECKBOX description: > SINGLE_SELECT (pick exactly one option), MULTI_SELECT (pick one or more options), SINGLE_CHECKBOX (a single boolean toggle), and the freeform/typed formats (TEXT, TEXTAREA, NUMBER, FILE, DATE). options: type: array items: type: string description: For SINGLE_SELECT and MULTI_SELECT. order: type: integer BudgetInput: type: object required: - window - budgetCents properties: window: type: string enum: - DAILY - WEEKLY - MONTHLY - LIFETIME budgetCents: type: integer minimum: 0 example: 50000 notes: type: - string - 'null' Error: type: object properties: error: type: object properties: code: type: string message: type: string fields: type: object additionalProperties: type: string required: - code - message responses: Unauthorized: description: Missing, unknown, or revoked partner key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INVALID_SERVICE_KEY message: Invalid service key. PaymentMethodRequired: description: A card on file is required before publishing. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: PAYMENT_METHOD_REQUIRED message: Add a payment method before publishing. NotFound: description: No such job for this key (including other companies' jobs). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: NOT_FOUND message: Job not found. AgreementOutdated: description: Terms must be accepted in the dashboard before publishing. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: AGREEMENT_OUTDATED message: >- Your organization must accept the current terms in the Sorce dashboard before publishing via the API. ValidationFailed: description: Bad input or incomplete listing; `fields` names each problem. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: VALIDATION_FAILED message: Validation failed. fields: salaryMin: Add a minimum salary. securitySchemes: bearerAuth: type: http scheme: bearer description: Partner key (`sk_ext_…`) bound to your company. ````