--- title: "Create a project" method: POST path: "/api/v2/cases/projects" tags: ["Case Management"] --- # Create a project `POST /api/v2/cases/projects` Create a project. ## Request body - ProjectCreateRequest — Project create request. - `data` ProjectCreate, required — Project create. - `attributes` ProjectCreateAttributes, required — Project creation attributes. - `enabled_custom_case_types` string[] — List of enabled custom case type IDs. - `key` string, required — Project's key. Cannot be "CASE". - `name` string, required — Project name. - `team_uuid` string — Team UUID to associate with the project. - `type` 'project', required — Project resource type. ## Response `201` CREATED - 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.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/versions/da68bf029e4c/schema)