--- title: "Update a project" method: PATCH path: "/api/v2/cases/projects/{project_id}" tags: ["Case Management"] --- # Update a project `PATCH /api/v2/cases/projects/{project_id}` ## Request - Base URL: `https://api.datadoghq.com` - URL: `https://api.datadoghq.com/api/v2/cases/projects/{project_id}` - 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 a project. ## Path parameters - `project_id` string, required ## Request body - ProjectUpdateRequest: Project update request. - `data` ProjectUpdate, required: Project update. - `attributes` ProjectUpdateAttributes: Project update attributes. - `columns_config` ProjectColumnsConfig: Project columns configuration. - `columns` ProjectColumnsConfigColumnsItems[]: List of column configurations for the project board view. - `sort` ProjectColumnsConfigColumnsItemsSort: Sort configuration for a project board column. - `ascending` boolean: Whether to sort in ascending order. - `priority` integer: The sort priority order for this column. - `sort_field` string: The field used to sort items in this column. - `type` string: The type of column. - `enabled_custom_case_types` string[]: List of enabled custom case type IDs. - `name` string: Project name. - `settings` ProjectSettings: Project settings. - `auto_close_inactive_cases` AutoCloseInactiveCases: Auto-close inactive cases settings. - `enabled` boolean: Whether auto-close is enabled. - `max_inactive_time_in_secs` integer: Maximum inactive time in seconds before auto-closing. - `auto_transition_assigned_cases` AutoTransitionAssignedCases: Auto-transition assigned cases settings. - `auto_transition_assigned_cases_on_self_assigned` boolean: Whether to auto-transition cases when self-assigned. - `integration_incident` IntegrationIncident: Incident integration settings. - `auto_escalation_query` string: Query for auto-escalation. - `default_incident_commander` string: Default incident commander. - `enabled` boolean: Whether incident integration is enabled. - `field_mappings` IntegrationIncidentFieldMappingsItems[]: List of mappings between incident fields and case fields. - `case_field` string: The case field to map the incident field value to. - `incident_user_defined_field_id` string: The identifier of the incident user-defined field to map from. - `incident_type` string: Incident type. - `severity_config` IntegrationIncidentSeverityConfig: Severity configuration for mapping incident priorities to case priorities. - `priority_mapping` object: Mapping of incident severity values to case priority values. - `integration_jira` IntegrationJira: Jira integration settings. - `auto_creation` IntegrationJiraAutoCreation: Auto-creation settings for Jira issues from cases. - `enabled` boolean: Whether automatic Jira issue creation is enabled. - `enabled` boolean: Whether Jira integration is enabled. - `metadata` IntegrationJiraMetadata: Metadata for connecting a case management project to a Jira project. - `account_id` string: The Jira account identifier. - `issue_type_id` string: The Jira issue type identifier to use when creating issues. - `project_id` string: The Jira project identifier to associate with this case project. - `sync` IntegrationJiraSync: Synchronization configuration for Jira integration. - `enabled` boolean: Whether Jira field synchronization is enabled. - `properties` IntegrationJiraSyncProperties: Field synchronization properties for Jira integration. - … - `integration_monitor` IntegrationMonitor: Monitor integration settings. - `auto_resolve_enabled` boolean: Whether auto-resolve is enabled. - `case_type_id` string: Case type ID for monitor integration. - `enabled` boolean: Whether monitor integration is enabled. - `handle` string: Monitor handle. - `integration_on_call` IntegrationOnCall: On-Call integration settings. - `auto_assign_on_call` boolean: Whether to auto-assign on-call. - `enabled` boolean: Whether On-Call integration is enabled. - `escalation_queries` IntegrationOnCallEscalationQueriesItems[]: List of escalation queries for routing cases to on-call responders. - `enabled` boolean: Whether this escalation query is enabled. - `id` string: Unique identifier of the escalation query. - `query` string: The query used to match cases for escalation. - `target` IntegrationOnCallEscalationQueriesItemsTarget: The target recipient for an On-Call escalation query. - … - `integration_service_now` IntegrationServiceNow: ServiceNow integration settings. - `assignment_group` string: Assignment group. - `auto_creation` IntegrationServiceNowAutoCreation: Auto-creation settings for ServiceNow incidents from cases. - `enabled` boolean: Whether automatic ServiceNow incident creation is enabled. - `enabled` boolean: Whether ServiceNow integration is enabled. - `instance_name` string: ServiceNow instance name. - `sync_config` IntegrationServiceNowSyncConfig: Synchronization configuration for ServiceNow integration. - `enabled` boolean: Whether ServiceNow synchronization is enabled. - `properties` IntegrationServiceNowSyncConfig139772721534496: Field-level synchronization properties for ServiceNow integration. - … - `notification` ProjectNotificationSettings: Project notification settings. - `destinations` integer[]: Notification destinations (1=email, 2=slack, 3=in-app). - `enabled` boolean: Whether notifications are enabled. - `notify_on_case_assignment` boolean: Whether to send a notification when a case is assigned. - `notify_on_case_closed` boolean: Whether to send a notification when a case is closed. - `notify_on_case_comment` boolean: Whether to send a notification when a comment is added to a case. - `notify_on_case_comment_mention` boolean: Whether to send a notification when a user is mentioned in a case comment. - `notify_on_case_priority_change` boolean: Whether to send a notification when a case's priority changes. - `notify_on_case_status_change` boolean: Whether to send a notification when a case's status changes. - `notify_on_case_unassignment` boolean: Whether to send a notification when a case is unassigned. - `team_uuid` string: Team UUID to associate with the project. - `type` 'project', required: Project resource type. ## Response `200` OK - ProjectResponse: Project response. - `data` Project: A Project. - `attributes` ProjectAttributes, required: Project attributes. - `columns_config` ProjectColumnsConfig: Project columns configuration. - `columns` ProjectColumnsConfigColumnsItems[]: List of column configurations for the project board view. - `sort` ProjectColumnsConfigColumnsItemsSort: Sort configuration for a project board column. - `ascending` boolean: Whether to sort in ascending order. - `priority` integer: The sort priority order for this column. - `sort_field` string: The field used to sort items in this column. - `type` string: The type of column. - `enabled_custom_case_types` string[]: List of enabled custom case type IDs. - `key` string: The project's key. - `name` string: Project's name. - `restricted` boolean: Whether the project is restricted. - `settings` ProjectSettings: Project settings. - `auto_close_inactive_cases` AutoCloseInactiveCases: Auto-close inactive cases settings. - `enabled` boolean: Whether auto-close is enabled. - `max_inactive_time_in_secs` integer: Maximum inactive time in seconds before auto-closing. - `auto_transition_assigned_cases` AutoTransitionAssignedCases: Auto-transition assigned cases settings. - `auto_transition_assigned_cases_on_self_assigned` boolean: Whether to auto-transition cases when self-assigned. - `integration_incident` IntegrationIncident: Incident integration settings. - `auto_escalation_query` string: Query for auto-escalation. - `default_incident_commander` string: Default incident commander. - `enabled` boolean: Whether incident integration is enabled. - `field_mappings` IntegrationIncidentFieldMappingsItems[]: List of mappings between incident fields and case fields. - `case_field` string: The case field to map the incident field value to. - `incident_user_defined_field_id` string: The identifier of the incident user-defined field to map from. - `incident_type` string: Incident type. - `severity_config` IntegrationIncidentSeverityConfig: Severity configuration for mapping incident priorities to case priorities. - `priority_mapping` object: Mapping of incident severity values to case priority values. - `integration_jira` IntegrationJira: Jira integration settings. - `auto_creation` IntegrationJiraAutoCreation: Auto-creation settings for Jira issues from cases. - `enabled` boolean: Whether automatic Jira issue creation is enabled. - `enabled` boolean: Whether Jira integration is enabled. - `metadata` IntegrationJiraMetadata: Metadata for connecting a case management project to a Jira project. - `account_id` string: The Jira account identifier. - `issue_type_id` string: The Jira issue type identifier to use when creating issues. - `project_id` string: The Jira project identifier to associate with this case project. - `sync` IntegrationJiraSync: Synchronization configuration for Jira integration. - `enabled` boolean: Whether Jira field synchronization is enabled. - `properties` IntegrationJiraSyncProperties: Field synchronization properties for Jira integration. - … - `integration_monitor` IntegrationMonitor: Monitor integration settings. - `auto_resolve_enabled` boolean: Whether auto-resolve is enabled. - `case_type_id` string: Case type ID for monitor integration. - `enabled` boolean: Whether monitor integration is enabled. - `handle` string: Monitor handle. - `integration_on_call` IntegrationOnCall: On-Call integration settings. - `auto_assign_on_call` boolean: Whether to auto-assign on-call. - `enabled` boolean: Whether On-Call integration is enabled. - `escalation_queries` IntegrationOnCallEscalationQueriesItems[]: List of escalation queries for routing cases to on-call responders. - `enabled` boolean: Whether this escalation query is enabled. - `id` string: Unique identifier of the escalation query. - `query` string: The query used to match cases for escalation. - `target` IntegrationOnCallEscalationQueriesItemsTarget: The target recipient for an On-Call escalation query. - … - `integration_service_now` IntegrationServiceNow: ServiceNow integration settings. - `assignment_group` string: Assignment group. - `auto_creation` IntegrationServiceNowAutoCreation: Auto-creation settings for ServiceNow incidents from cases. - `enabled` boolean: Whether automatic ServiceNow incident creation is enabled. - `enabled` boolean: Whether ServiceNow integration is enabled. - `instance_name` string: ServiceNow instance name. - `sync_config` IntegrationServiceNowSyncConfig: Synchronization configuration for ServiceNow integration. - `enabled` boolean: Whether ServiceNow synchronization is enabled. - `properties` IntegrationServiceNowSyncConfig139772721534496: Field-level synchronization properties for ServiceNow integration. - … - `notification` ProjectNotificationSettings: Project notification settings. - `destinations` integer[]: Notification destinations (1=email, 2=slack, 3=in-app). - `enabled` boolean: Whether notifications are enabled. - `notify_on_case_assignment` boolean: Whether to send a notification when a case is assigned. - `notify_on_case_closed` boolean: Whether to send a notification when a case is closed. - `notify_on_case_comment` boolean: Whether to send a notification when a comment is added to a case. - `notify_on_case_comment_mention` boolean: Whether to send a notification when a user is mentioned in a case comment. - `notify_on_case_priority_change` boolean: Whether to send a notification when a case's priority changes. - `notify_on_case_status_change` boolean: Whether to send a notification when a case's status changes. - `notify_on_case_unassignment` boolean: Whether to send a notification when a case is unassigned. - `id` string, required: The Project's identifier. - `relationships` ProjectRelationships: Project relationships. - `member_team` RelationshipToTeamLinks: Relationship between a team and a team link - `data` RelationshipToTeamLinkData[]: Related team links - `id` string, required: The team link's identifier - `type` 'team_links', required: Team link type - `links` TeamRelationshipsLinks: Links attributes. - `related` string: Related link. - `member_user` UsersRelationship: Relationship to users. - `data` UserRelationshipData[], required: Relationships to user objects. - `id` string, required: A unique identifier that represents the user. - `type` 'user', required: User resource type. - `type` 'project', required: Project resource type. ## 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)