---
title: "Update case title"
method: POST
path: "/api/v2/cases/{case_id}/title"
tags: ["Case Management"]
---

# Update case title

`POST /api/v2/cases/{case_id}/title`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/cases/{case_id}/title`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `cases_write`

Update case title

## Path parameters

- `case_id` string, required

## Request body

- CaseUpdateTitleRequest: Case update title request
  - `data` CaseUpdateTitle, required: Case update title
    - `attributes` CaseUpdateTitleAttributes, required: Case update title attributes
      - `title` string, required: Case new title
    - `type` 'case', required: JSON:API resource type for cases.

## Response `200`

OK

- CaseResponse: Case response
  - `data` Case: A case
    - `attributes` CaseAttributes, required: Case resource attributes
      - `archived_at` string, date-time, nullable: Timestamp of when the case was archived
      - `attributes` CaseObjectAttributes: Key-value pairs of case attributes. Each key maps to an array of string values, used for flexible metadata such as labels or tags.
      - `closed_at` string, date-time, nullable: Timestamp of when the case was closed
      - `created_at` string, date-time: Timestamp of when the case was created
      - `custom_attributes` object: Case custom attributes
      - `description` string: Description
      - `jira_issue` JiraIssue, nullable: Jira issue attached to case
        - `result` JiraIssueResult: Jira issue information
          - `issue_id` string: Jira issue ID
          - `issue_key` string: Jira issue key
          - `issue_url` string: Jira issue URL
          - `project_key` string: Jira project key
        - `status` 'IN_PROGRESS' | 'COMPLETED' | 'FAILED': Case status
      - `key` string: Key
      - `modified_at` string, date-time, nullable: Timestamp of when the case was last modified
      - `priority` 'NOT_DEFINED' | 'P1' | 'P2' | 'P3' | 'P4' | 'P5': Case priority
      - `service_now_ticket` ServiceNowTicket, nullable: ServiceNow ticket attached to case
        - `result` ServiceNowTicketResult: ServiceNow ticket information
          - `sys_target_link` string: Link to the Incident created on ServiceNow
        - `status` 'IN_PROGRESS' | 'COMPLETED' | 'FAILED': Case status
      - `status` 'OPEN' | 'IN_PROGRESS' | 'CLOSED': Deprecated way of representing the case status, which only supports OPEN, IN_PROGRESS, and CLOSED statuses. Use `status_name` instead.
      - `status_group` 'SG_OPEN' | 'SG_IN_PROGRESS' | 'SG_CLOSED': Status group of the case.
      - `status_name` string: Status of the case. Must be one of the existing statuses for the case's type.
      - `title` string: Title
      - `type` 'STANDARD': Case type
      - `type_id` string: Case type UUID
    - `id` string, required: Case's identifier
    - `relationships` CaseRelationships: Resources related to a case
      - `assignee` NullableUserRelationship, nullable: Relationship to user.
        - `data` NullableUserRelationshipData, nullable, required: Relationship to user object.
          - `id` string, required: A unique identifier that represents the user.
          - `type` 'user', required: User resource type.
      - `created_by` NullableUserRelationship, nullable: Relationship to user.
        - `data` NullableUserRelationshipData, nullable, required: Relationship to user object.
          - `id` string, required: A unique identifier that represents the user.
          - `type` 'user', required: User resource type.
      - `modified_by` NullableUserRelationship, nullable: Relationship to user.
        - `data` NullableUserRelationshipData, nullable, required: Relationship to user object.
          - `id` string, required: A unique identifier that represents the user.
          - `type` 'user', required: User resource type.
      - `project` ProjectRelationship: Relationship to project.
        - `data` ProjectRelationshipData, required: Relationship to project object.
          - `id` string, required: A unique identifier that represents the project.
          - `type` 'project', required: Project resource type.
    - `type` 'case', required: JSON:API resource type for cases.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)