Atomicwork Problems API

The problems API from Atomicwork — 4 operation(s) for problems.

GitHub OpenAPI
Business capability
IT Service Management BC-600.30

Operations 7

POST /api/v1/problems Create problem request #
GET /api/v1/problems/{display_id}/assessment-form Retrieve Problem Request Assessment Form #
POST /api/v1/problems/{display_id}/assessment-form Update Problem Request Assessment Form #
GET /api/v1/problems/{display_id}/tasks Retrieve Problem Request Tasks #
POST /api/v1/problems/{display_id}/tasks Create task for problem request #
GET /api/v1/problems/{display_id}/tasks/{task_id} Retrieve Problem Request Task #
PUT /api/v1/problems/{display_id}/tasks/{task_id} Update Problem Request Task #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/atomicwork:atomicwork-problems-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

atomicwork-problems-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Atomicwork Public Problems API
  version: 1.0.0
servers:
- url: https://{tenant}.atomicwork.com
  description: Your Atomicwork tenant
tags:
- name: Problems
paths:
  /api/v1/problems:
    post:
      operationId: problems_postapi_v1_problems
      summary: Create problem request
      tags:
      - Problems
      parameters:
      - name: X-Workspace-Id
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problems_postapi_v1_problems_Response_200'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                request_type:
                  type: string
                request_source:
                  $ref: '#/components/schemas/ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaRequestSource'
                category:
                  type: string
                subcategory:
                  type: string
                cti_item:
                  type: string
                description:
                  type: string
                email_content:
                  type: string
                status:
                  type: string
                priority:
                  type: string
                parent_request_id:
                  type: integer
                  format: int64
                agent_group:
                  type: integer
                  format: int64
                  description: ID of the agent group to associate with the request. Members of this group are included in follower notifications when the group is also a request follower.
                assignee:
                  type: integer
                  format: int64
                  description: ID of the user assigned to the request.
                subject:
                  type: string
                notes:
                  type: array
                  items:
                    $ref: '#/components/schemas/ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaNotesItems'
                workspace_id:
                  type: integer
                  format: int64
                conversation_info:
                  $ref: '#/components/schemas/ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaConversationInfo'
                tags:
                  type: array
                  items:
                    type: integer
                    format: int64
                cc_emails:
                  type: array
                  items:
                    type: string
                bcc_emails:
                  type: array
                  items:
                    type: string
                attachments:
                  type: array
                  items:
                    type: integer
                    format: int64
                requester:
                  type: integer
                  format: int64
                to_email:
                  type: string
                request_created_from:
                  $ref: '#/components/schemas/ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaRequestCreatedFrom'
                custom_fields:
                  $ref: '#/components/schemas/ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaCustomFields'
                created_at:
                  type: string
                  format: date-time
                updated_at:
                  type: string
                  format: date-time
                external_id:
                  type: string
                external_source:
                  $ref: '#/components/schemas/ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaExternalSource'
                resolution_time:
                  type: string
                  format: date-time
                  description: 'When the ticket was resolved in the source system. Only accepted during migration (requires external_id or external_source).

                    '
                first_response_time:
                  type: string
                  format: date-time
                  description: 'When the first agent response occurred in the source system. Only accepted during migration (requires external_id or external_source).

                    '
                first_response_due_time:
                  type: string
                  format: date-time
                  description: 'SLA due time for first response from the source system. Only accepted during migration (requires external_id or external_source).

                    '
                resolution_due_time:
                  type: string
                  format: date-time
                  description: 'SLA due time for resolution from the source system. Only accepted during migration (requires external_id or external_source).

                    '
                closed_status_at:
                  type: string
                  format: date-time
                  description: 'When the ticket was moved to closed status in the source system. Only accepted during migration (requires external_id or external_source). When provided with a closed status, also sets resolution_time if not explicitly provided.

                    '
                item_id:
                  type: integer
                  format: int64
                item_fields:
                  $ref: '#/components/schemas/ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaItemFields'
                impact:
                  type: string
                urgency:
                  type: string
                assets:
                  type: array
                  items:
                    type: integer
                    format: int64
      security:
      - ApiKeyAuth: []
  /api/v1/problems/{display_id}/assessment-form:
    get:
      operationId: problems_getapi_v1_problems__display_id__assessment_form
      summary: Retrieve Problem Request Assessment Form
      tags:
      - Problems
      parameters:
      - name: display_id
        in: path
        description: The problem ID
        required: true
        schema:
          type: string
      - name: X-Workspace-Id
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problems_getapi_v1_problems__display_id__assessment_form_Response_200'
      security:
      - ApiKeyAuth: []
    post:
      operationId: problems_postapi_v1_problems__display_id__assessment_form
      summary: Update Problem Request Assessment Form
      tags:
      - Problems
      parameters:
      - name: display_id
        in: path
        description: The problem ID
        required: true
        schema:
          type: string
      - name: X-Workspace-Id
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problems_postapi_v1_problems__display_id__assessment_form_Response_200'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                form_fields:
                  $ref: '#/components/schemas/ApiV1ProblemsDisplayIdAssessmentFormPostRequestBodyContentApplicationJsonSchemaFormFields'
              required:
              - form_fields
      security:
      - ApiKeyAuth: []
  /api/v1/problems/{display_id}/tasks:
    get:
      operationId: problems_getapi_v1_problems__display_id__tasks
      summary: Retrieve Problem Request Tasks
      tags:
      - Problems
      parameters:
      - name: display_id
        in: path
        description: The problem ID
        required: true
        schema:
          type: string
      - name: X-Workspace-Id
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problems_getapi_v1_problems__display_id__tasks_Response_200'
      security:
      - ApiKeyAuth: []
    post:
      operationId: problems_postapi_v1_problems__display_id__tasks
      summary: Create task for problem request
      tags:
      - Problems
      parameters:
      - name: display_id
        in: path
        description: The problem ID
        required: true
        schema:
          type: string
      - name: X-Workspace-Id
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problems_postapi_v1_problems__display_id__tasks_Response_200'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                description:
                  type: string
                due_date:
                  type: string
                  format: date
                assignee:
                  type: integer
                  format: int64
                status:
                  $ref: '#/components/schemas/ApiV1ProblemsDisplayIdTasksPostRequestBodyContentApplicationJsonSchemaStatus'
      security:
      - ApiKeyAuth: []
  /api/v1/problems/{display_id}/tasks/{task_id}:
    get:
      operationId: problems_getapi_v1_problems__display_id__tasks__task_id
      summary: Retrieve Problem Request Task
      tags:
      - Problems
      parameters:
      - name: display_id
        in: path
        description: The problem ID
        required: true
        schema:
          type: string
      - name: task_id
        in: path
        description: The task ID
        required: true
        schema:
          type: integer
          format: int64
      - name: X-Workspace-Id
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problems_getapi_v1_problems__display_id__tasks__task_id_Response_200'
      security:
      - ApiKeyAuth: []
    put:
      operationId: problems_putapi_v1_problems__display_id__tasks__task_id
      summary: Update Problem Request Task
      tags:
      - Problems
      parameters:
      - name: display_id
        in: path
        description: The problem ID
        required: true
        schema:
          type: string
      - name: task_id
        in: path
        description: The task ID
        required: true
        schema:
          type: integer
          format: int64
      - name: X-Workspace-Id
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problems_putapi_v1_problems__display_id__tasks__task_id_Response_200'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                description:
                  type: string
                due_date:
                  type: string
                  format: date
                assignee:
                  type: integer
                  format: int64
                status:
                  $ref: '#/components/schemas/ApiV1ProblemsDisplayIdTasksTaskIdPutRequestBodyContentApplicationJsonSchemaStatus'
      security:
      - ApiKeyAuth: []
components:
  schemas:
    Problems_postapi_v1_problems_Response_200:
      type: object
      properties: {}
      description: Empty response body
      title: Problems_postapi_v1_problems_Response_200
    ApiV1ProblemsDisplayIdAssessmentFormPostRequestBodyContentApplicationJsonSchemaFormFields:
      type: object
      properties: {}
      title: ApiV1ProblemsDisplayIdAssessmentFormPostRequestBodyContentApplicationJsonSchemaFormFields
    ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaNotesItemsExternalSourceType:
      type: string
      enum:
      - SAAS_GENIE
      - SNOW
      - JSM_BRIDGE
      title: ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaNotesItemsExternalSourceType
    ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaRequestCreatedFrom:
      type: object
      properties:
        id:
          type: string
        type:
          $ref: '#/components/schemas/ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaRequestCreatedFromType'
      title: ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaRequestCreatedFrom
    Problems_postapi_v1_problems__display_id__tasks_Response_200:
      type: object
      properties: {}
      description: Empty response body
      title: Problems_postapi_v1_problems__display_id__tasks_Response_200
    Problems_putapi_v1_problems__display_id__tasks__task_id_Response_200:
      type: object
      properties: {}
      description: Empty response body
      title: Problems_putapi_v1_problems__display_id__tasks__task_id_Response_200
    ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaNotesItemsType:
      type: string
      enum:
      - ESD_NOTE
      - SLACK_NOTE
      - EMAIL_NOTE
      - RATING
      - TEMPLATE
      - WORKFLOW_NOTE
      title: ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaNotesItemsType
    Problems_postapi_v1_problems__display_id__assessment_form_Response_200:
      type: object
      properties: {}
      description: Empty response body
      title: Problems_postapi_v1_problems__display_id__assessment_form_Response_200
    ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaItemFields:
      type: object
      properties: {}
      title: ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaItemFields
    ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaNotesItems:
      type: object
      properties:
        user_id:
          type: integer
          format: int64
        conversation_id:
          type: integer
          format: int64
          description: When set, the reply is mirrored into this conversation's thread (UAG).
        description:
          type: string
        mentions:
          type: array
          items:
            type: integer
            format: int64
          description: User IDs mentioned in the note. Mentioned users are notified and added as direct followers.
        agent_group_mentions:
          type: array
          items:
            type: integer
            format: int64
          description: 'Agent group IDs mentioned in the note. Members of these groups are notified

            and the groups are added as request followers.

            '
        is_private:
          type: boolean
          default: false
        source:
          $ref: '#/components/schemas/ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaNotesItemsSource'
        type:
          $ref: '#/components/schemas/ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaNotesItemsType'
        attachments:
          type: array
          items:
            type: integer
            format: int64
        cc_emails:
          type: array
          items:
            type: string
        bcc_emails:
          type: array
          items:
            type: string
        is_broadcast:
          type: boolean
          default: false
        external_id:
          type: string
        external_source_type:
          $ref: '#/components/schemas/ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaNotesItemsExternalSourceType'
        email_content:
          type: string
        event_created_at:
          type: string
          format: date-time
          description: Event creation timestamp. When provided via public API, also backdates the note's created time, SLA metrics, and activity timestamps. Must not be in the future or before the request's creation time.
        transition:
          $ref: '#/components/schemas/ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaNotesItemsTransition'
          description: 'Applied in the same transaction as the note: both commit, or neither does. Takes the same body PATCH /requests/{requestId} accepts'
      description: 'Payload to create a request note. Mentions (`mentions`) and agent-group mentions

        (`agent_group_mentions`) can be supplied. Public notes notify the requester,

        assignee and all followers (direct users plus members of any agent groups following

        the request, de-duplicated). Agent groups listed in `agent_group_mentions` are

        added as request followers.

        '
      title: ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaNotesItems
    ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaConversationInfo:
      type: object
      properties:
        channel_name:
          type: string
        channel_id:
          type: string
        start_timestamp:
          type: string
          format: unix-timestamp
      required:
      - start_timestamp
      title: ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaConversationInfo
    ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaRequestSource:
      type: string
      enum:
      - EMAIL
      - SLACK
      - TEAMS
      - PORTAL
      - WORKFLOW
      - JOURNEY
      - API
      - UNIVERSAL_AGENT
      title: ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaRequestSource
    ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaNotesItemsTransition:
      type: object
      properties: {}
      description: 'Applied in the same transaction as the note: both commit, or neither does. Takes the same body PATCH /requests/{requestId} accepts'
      title: ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaNotesItemsTransition
    Problems_getapi_v1_problems__display_id__assessment_form_Response_200:
      type: object
      properties: {}
      description: Empty response body
      title: Problems_getapi_v1_problems__display_id__assessment_form_Response_200
    ApiV1ProblemsDisplayIdTasksPostRequestBodyContentApplicationJsonSchemaStatus:
      type: string
      enum:
      - OPEN
      - IN_PROGRESS
      - COMPLETE
      title: ApiV1ProblemsDisplayIdTasksPostRequestBodyContentApplicationJsonSchemaStatus
    ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaExternalSource:
      type: string
      enum:
      - SAAS_GENIE
      - SNOW
      - JSM_BRIDGE
      title: ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaExternalSource
    ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaNotesItemsSource:
      type: string
      enum:
      - EMAIL
      - SLACK
      - TEAMS
      - PORTAL
      - WORKFLOW
      - JOURNEY
      - API
      - UNIVERSAL_AGENT
      title: ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaNotesItemsSource
    Problems_getapi_v1_problems__display_id__tasks__task_id_Response_200:
      type: object
      properties: {}
      description: Empty response body
      title: Problems_getapi_v1_problems__display_id__tasks__task_id_Response_200
    ApiV1ProblemsDisplayIdTasksTaskIdPutRequestBodyContentApplicationJsonSchemaStatus:
      type: string
      enum:
      - OPEN
      - IN_PROGRESS
      - COMPLETE
      title: ApiV1ProblemsDisplayIdTasksTaskIdPutRequestBodyContentApplicationJsonSchemaStatus
    Problems_getapi_v1_problems__display_id__tasks_Response_200:
      type: object
      properties: {}
      description: Empty response body
      title: Problems_getapi_v1_problems__display_id__tasks_Response_200
    ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaRequestCreatedFromType:
      type: string
      enum:
      - REQUEST_SETTINGS
      title: ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaRequestCreatedFromType
    ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaCustomFields:
      type: object
      properties: {}
      title: ApiV1ProblemsPostRequestBodyContentApplicationJsonSchemaCustomFields
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
x-provenance:
  method: harvested
  publisher: Atomicwork
  source: https://support.atomicwork.com/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)