> ## Documentation Index > Fetch the complete documentation index at: https://docs.versori.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a new issue. ## OpenAPI ````yaml /openapi/platform-api.yaml post /o/{organisation_id}/issues openapi: 3.1.0 info: title: Versori Platform API version: 0.0.1 license: name: UNLICENSED servers: - description: Production url: https://platform.versori.com/api/v2 - description: Staging url: https://platform-staging.versori.com/api/v2 - description: Development url: http://localhost:8901 security: - bearerToken: [] - cookie: [] paths: /o/{organisation_id}/issues: parameters: - $ref: '#/components/parameters/organisation_id' post: tags: - issues summary: Create a new issue. operationId: CreateIssue requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateIssue' responses: '201': description: Created content: application/json: schema: $ref: '#/components/schemas/Issue' default: description: Error content: application/json: schema: $ref: '#/components/schemas/Error' components: parameters: organisation_id: name: organisation_id in: path required: true schema: type: string format: ulid x-go-type: ulid.ULID x-go-name: OrganisationID x-go-type-import: path: versori.dev/vergo/ulid schemas: CreateIssue: type: object required: - reason - project_id - environmentId - organisationId - severity - title properties: organisationId: type: string description: ID of the organization the issue belongs to x-go-type: ulid.ULID x-go-type-import: path: versori.dev/vergo/ulid x-go-type-skip-optional-pointer: true projectId: type: string description: ID of the project the issue belongs to x-go-type: ulid.ULID x-go-type-import: path: versori.dev/vergo/ulid x-go-type-skip-optional-pointer: true environmentId: type: string description: ID of the environment the issue occurred in x-go-type: ulid.ULID x-go-type-import: path: versori.dev/vergo/ulid x-go-type-skip-optional-pointer: true reason: $ref: '#/components/schemas/IssueReasonEnum' message: type: string description: Detailed message of the issue title: type: string description: Title of the issue labels: type: object description: Key-value pairs for searchable labels additionalProperties: type: string x-go-type-skip-optional-pointer: true annotations: type: object description: Key-value pairs for additional non-searchable information additionalProperties: type: string x-go-type-skip-optional-pointer: true severity: $ref: '#/components/schemas/IssueSeverityEnum' Issue: type: object required: - id - organisationId - projectId - environmentId - status - reason - message - title - labels - annotations - duplication - createdAt - lastSeenAt - seenCount properties: id: type: string description: Unique identifier for the issue (ULID) x-go-type: ulid.ULID x-go-type-import: path: versori.dev/vergo/ulid x-go-type-skip-optional-pointer: true organisationId: type: string description: ID of the organization the isszue belongs to x-go-type: ulid.ULID x-go-type-import: path: versori.dev/vergo/ulid x-go-type-skip-optional-pointer: true projectId: type: string description: ID of the project the issue belongs to x-go-type: ulid.ULID x-go-type-import: path: versori.dev/vergo/ulid x-go-type-skip-optional-pointer: true environmentId: type: string description: ID of the environment the issue occurred in x-go-type: ulid.ULID x-go-type-import: path: versori.dev/vergo/ulid x-go-type-skip-optional-pointer: true status: $ref: '#/components/schemas/IssueStatusEnum' reason: $ref: '#/components/schemas/IssueReasonEnum' message: type: string description: Detailed message of the issue title: type: string description: Title of the issue labels: type: object description: Key-value pairs for searchable labels additionalProperties: type: string x-go-type-skip-optional-pointer: true annotations: type: object description: Key-value pairs for additional non-searchable information additionalProperties: type: string x-go-type-skip-optional-pointer: true resolutionStatus: $ref: '#/components/schemas/IssueResolutionStatusEnum' createdAt: type: string format: date-time description: Timestamp when the issue was created resolvedAt: type: string format: date-time nullable: true description: Timestamp when the issue was resolved lastSeenAt: type: string format: date-time description: Timestamp when the issue was last seen seenCount: type: integer description: Number of times the issue has been seen severity: $ref: '#/components/schemas/IssueSeverityEnum' Error: type: object properties: code: type: string description: Code is a machine-readable error code. message: type: string description: Message is a human-readable error message. fields: type: array items: $ref: '#/components/schemas/ErrorField' x-go-type-skip-optional-pointer: true details: type: string x-go-type-skip-optional-pointer: true required: - code - message IssueReasonEnum: type: string enum: - error - manual description: Reason for the issue creation IssueSeverityEnum: type: string enum: - high - low - medium description: Severity level of the issue IssueStatusEnum: type: string enum: - open - closed - acked - resolved description: Current status of the issue IssueResolutionStatusEnum: type: string enum: - resolved - negated - ignored description: Status of the issue resolution ErrorField: description: ErrorField denotes a field which has an error. type: object properties: field: type: string description: > Field is the name of the field which has an error, this may be a path to a nested field, including array elements. The format of this field is of the form: "field1.field2[0].field3" message: type: string description: Message is the error message for this specific field. required: - field - message securitySchemes: bearerToken: description: > Bearer token authentication used by the Versori Platform. External consumers must provide an API key, however internal consumers must provide a JWT id_token issued by our IdP. type: http scheme: bearer cookie: description: Cookie authentication used by the Versori Platform. type: apiKey in: cookie name: cookie ````