datadog_api_client 2.25.0 → 2.26.0

data/.generator/schemas/v2/openapi.yaml

@@ -202,6 +202,14 @@ components:
       required: true
       schema:
         type: string
+    EntityID:
+      description: UUID or Entity Ref
+      in: path
+      name: entity_id
+      required: true
+      schema:
+        example: service:myservice
+        type: string
     FastlyAccountID:
       description: Fastly Account id.
       in: path
@@ -223,6 +231,61 @@ components:
       required: true
       schema:
         type: string
+    FilterByExcludeSnapshot:
+      description: Filter entities by excluding snapshotted entities
+      in: query
+      name: fitler[exclude_snapshot]
+      required: false
+      schema:
+        type: string
+    FilterByID:
+      description: Filter entities by UUID
+      explode: true
+      in: query
+      name: fitler[id]
+      required: false
+      schema:
+        type: string
+    FilterByKind:
+      description: Filter entities by kind
+      explode: true
+      in: query
+      name: fitler[kind]
+      required: false
+      schema:
+        type: string
+    FilterByName:
+      description: Filter entities by name
+      explode: true
+      in: query
+      name: fitler[name]
+      required: false
+      schema:
+        type: string
+    FilterByOwner:
+      description: Filter entities by owner
+      explode: true
+      in: query
+      name: fitler[owner]
+      required: false
+      schema:
+        type: string
+    FilterByRef:
+      description: Filter entities by reference
+      explode: true
+      in: query
+      name: fitler[ref]
+      required: false
+      schema:
+        type: string
+    FilterByRelationType:
+      description: Filter entities by relation type
+      explode: true
+      in: query
+      name: fitler[relation][type]
+      required: false
+      schema:
+        $ref: '#/components/schemas/RelationType'
     GCPSTSServiceAccountID:
       description: Your GCP STS enabled service account's unique ID.
       in: path
@@ -358,6 +421,14 @@ components:
       required: true
       schema:
         type: string
+    Include:
+      description: include relationship data
+      explode: true
+      in: query
+      name: include
+      required: false
+      schema:
+        $ref: '#/components/schemas/IncludeType'
     InstanceId:
       description: The ID of the workflow instance.
       in: path
@@ -662,6 +733,8 @@ components:
       properties:
         errors:
           description: A list of errors.
+          example:
+          - Bad Request
           items:
             description: A list of items.
             example: Bad Request
@@ -673,10 +746,16 @@ components:
     APIKeyCreateAttributes:
       description: Attributes used to create an API Key.
       properties:
+        category:
+          description: The APIKeyCreateAttributes category.
+          type: string
         name:
           description: Name of the API key.
           example: API Key for submitting metrics
           type: string
+        remote_config_read_enabled:
+          description: The APIKeyCreateAttributes remote_config_read_enabled.
+          type: boolean
       required:
       - name
       type: object
@@ -722,13 +801,20 @@ components:
       description: An object related to an API key.
       oneOf:
       - $ref: '#/components/schemas/User'
+      - $ref: '#/components/schemas/LeakedKey'
     APIKeyUpdateAttributes:
       description: Attributes used to update an API Key.
       properties:
+        category:
+          description: The APIKeyUpdateAttributes category.
+          type: string
         name:
           description: Name of the API key.
           example: API Key for submitting metrics
           type: string
+        remote_config_read_enabled:
+          description: The APIKeyUpdateAttributes remote_config_read_enabled.
+          type: boolean
       required:
       - name
       type: object
@@ -981,6 +1067,7 @@ components:
       oneOf:
       - $ref: '#/components/schemas/User'
       - $ref: '#/components/schemas/Role'
+      - $ref: '#/components/schemas/LeakedKey'
     ApplicationKeyResponseMeta:
       description: Additional information related to the application key response.
       properties:
@@ -2368,7 +2455,6 @@ components:
         author_email:
           description: The commit author email.
           example: author@example.com
-          format: email
           type: string
         author_name:
           description: The commit author name.
@@ -2393,7 +2479,6 @@ components:
         committer_email:
           description: The committer email.
           example: committer@example.com
-          format: email
           nullable: true
           type: string
         committer_name:
@@ -4484,6 +4569,9 @@ components:
             key is provided (and not a token), this field is also required.
           example: test-email@example.com
           type: string
+        name:
+          description: The name of the Cloudflare account.
+          type: string
         resources:
           description: An allowlist of resources to restrict pulling metrics for.
           example:
@@ -5879,7 +5967,6 @@ components:
       - $ref: '#/components/schemas/CustomDestinationForwardDestinationHttp'
       - $ref: '#/components/schemas/CustomDestinationForwardDestinationSplunk'
       - $ref: '#/components/schemas/CustomDestinationForwardDestinationElasticsearch'
-      type: object
     CustomDestinationForwardDestinationElasticsearch:
       description: The Elasticsearch destination.
       properties:
@@ -6000,7 +6087,6 @@ components:
       oneOf:
       - $ref: '#/components/schemas/CustomDestinationHttpDestinationAuthBasic'
       - $ref: '#/components/schemas/CustomDestinationHttpDestinationAuthCustomHeader'
-      type: object
     CustomDestinationHttpDestinationAuthBasic:
       description: Basic access authentication.
       properties:
@@ -6140,7 +6226,6 @@ components:
       - $ref: '#/components/schemas/CustomDestinationResponseForwardDestinationHttp'
       - $ref: '#/components/schemas/CustomDestinationResponseForwardDestinationSplunk'
       - $ref: '#/components/schemas/CustomDestinationResponseForwardDestinationElasticsearch'
-      type: object
     CustomDestinationResponseForwardDestinationElasticsearch:
       description: The Elasticsearch destination.
       properties:
@@ -6254,7 +6339,6 @@ components:
       oneOf:
       - $ref: '#/components/schemas/CustomDestinationResponseHttpDestinationAuthBasic'
       - $ref: '#/components/schemas/CustomDestinationResponseHttpDestinationAuthCustomHeader'
-      type: object
     CustomDestinationResponseHttpDestinationAuthBasic:
       description: Basic access authentication.
       properties:
@@ -6408,7 +6492,7 @@ components:
           description: Deployment ID.
           type: string
         service:
-          description: Service name from a service available in the Service Catalog.
+          description: Service name.
           example: shopist
           type: string
         started_at:
@@ -7538,6 +7622,814 @@ components:
       - type
       - attributes
       type: object
+    EntityAttributes:
+      description: Entity attributes.
+      properties:
+        apiVersion:
+          description: The api version.
+          type: string
+        description:
+          description: The description.
+          type: string
+        displayName:
+          description: The display name.
+          type: string
+        kind:
+          description: The kind.
+          type: string
+        name:
+          description: The name.
+          type: string
+        namespace:
+          description: The namespace.
+          type: string
+        owner:
+          description: The owner.
+          type: string
+        tags:
+          description: The tags.
+          items:
+            type: string
+          type: array
+      type: object
+    EntityData:
+      description: Entity data.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/EntityAttributes'
+        id:
+          description: Entity id.
+          type: string
+        meta:
+          $ref: '#/components/schemas/EntityMeta'
+        relationships:
+          $ref: '#/components/schemas/EntityRelationships'
+        type:
+          description: Entity.
+          type: string
+      type: object
+    EntityMeta:
+      description: Entity metadata.
+      properties:
+        createdAt:
+          description: The creation time.
+          type: string
+        ingestionSource:
+          description: The ingestion source.
+          type: string
+        modifiedAt:
+          description: The modification time.
+          type: string
+        origin:
+          description: The origin.
+          type: string
+      type: object
+    EntityRaw:
+      description: Entity definition in raw JSON/YAML representation.
+      example: "apiVersion: v3\nkind: service\nmetadata:\n  name: myservice\n"
+      type: string
+    EntityRelationships:
+      description: Entity relationships.
+      properties:
+        incidents:
+          $ref: '#/components/schemas/EntityToIncidents'
+        oncall:
+          $ref: '#/components/schemas/EntityToOncalls'
+        rawSchema:
+          $ref: '#/components/schemas/EntityToRawSchema'
+        relatedEntities:
+          $ref: '#/components/schemas/EntityToRelatedEntities'
+        schema:
+          $ref: '#/components/schemas/EntityToSchema'
+      type: object
+    EntityResponseData:
+      description: List of entity data.
+      items:
+        $ref: '#/components/schemas/EntityData'
+      type: array
+    EntityResponseIncludedIncident:
+      description: Included incident.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/EntityResponseIncludedRelatedIncidentAttributes'
+        id:
+          description: Incident id.
+          type: string
+        type:
+          description: Incident description.
+          type: string
+      type: object
+    EntityResponseIncludedOncall:
+      description: Included oncall.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/EntityResponseIncludedRelatedOncallAttributes'
+        id:
+          description: Oncall ID.
+          type: string
+        type:
+          description: Oncall type.
+          type: string
+      type: object
+    EntityResponseIncludedRawSchema:
+      description: Included raw schema.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/EntityResponseIncludedRawSchemaAttributes'
+        id:
+          description: Raw schema id.
+          type: string
+        type:
+          description: Raw schema type.
+          type: string
+      type: object
+    EntityResponseIncludedRawSchemaAttributes:
+      description: Included raw schema attributes.
+      properties:
+        rawSchema:
+          description: Schema from user input in base64 encoding.
+          type: string
+      type: object
+    EntityResponseIncludedRelatedEntity:
+      description: Included related entity.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/EntityResponseIncludedRelatedEntityAttributes'
+        id:
+          description: Entity UUID.
+          type: string
+        meta:
+          $ref: '#/components/schemas/EntityResponseIncludedRelatedEntityMeta'
+        type:
+          description: Related entity.
+          type: string
+      type: object
+    EntityResponseIncludedRelatedEntityAttributes:
+      description: Related entity attributes.
+      properties:
+        kind:
+          description: Entity kind.
+          type: string
+        name:
+          description: Entity name.
+          type: string
+        namespace:
+          description: Entity namespace.
+          type: string
+        type:
+          description: Entity relation type to the associated entity.
+          type: string
+      type: object
+    EntityResponseIncludedRelatedEntityMeta:
+      description: Included related entity meta.
+      properties:
+        createdAt:
+          description: Entity creation time.
+          format: date-time
+          type: string
+        defined_by:
+          description: Entity relation defined by.
+          type: string
+        modifiedAt:
+          description: Entity modification time.
+          format: date-time
+          type: string
+        source:
+          description: Entity relation source.
+          type: string
+      type: object
+    EntityResponseIncludedRelatedIncidentAttributes:
+      description: Incident attributes.
+      properties:
+        createdAt:
+          description: Incident creation time.
+          format: date-time
+          type: string
+        htmlURL:
+          description: Incident URL.
+          type: string
+        provider:
+          description: Incident provider.
+          type: string
+        status:
+          description: Incident status.
+          type: string
+        title:
+          description: Incident title.
+          type: string
+      type: object
+    EntityResponseIncludedRelatedOncallAttributes:
+      description: Included related oncall attributes.
+      properties:
+        escalations:
+          $ref: '#/components/schemas/EntityResponseIncludedRelatedOncallEscalations'
+        provider:
+          description: Oncall provider.
+          type: string
+      type: object
+    EntityResponseIncludedRelatedOncallEscalationItem:
+      description: Oncall escalation
+      properties:
+        email:
+          description: Oncall email.
+          type: string
+        escalationLevel:
+          description: Oncall level.
+          format: int64
+          type: integer
+        name:
+          description: Oncall name.
+          type: string
+      type: object
+    EntityResponseIncludedRelatedOncallEscalations:
+      description: Oncall escalations
+      items:
+        $ref: '#/components/schemas/EntityResponseIncludedRelatedOncallEscalationItem'
+      type: array
+    EntityResponseIncludedSchema:
+      description: Included detail entity schema.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/EntityResponseIncludedSchemaAttributes'
+        id:
+          description: Entity id.
+          type: string
+        type:
+          description: Schema type.
+          type: string
+      type: object
+    EntityResponseIncludedSchemaAttributes:
+      description: Included schema.
+      properties:
+        schema:
+          $ref: '#/components/schemas/EntityV3'
+      type: object
+    EntityResponseMeta:
+      description: Entity metadata.
+      properties:
+        count:
+          description: Total entities count.
+          format: int64
+          type: integer
+        includeCount:
+          description: Total included data count.
+          format: int64
+          type: integer
+      type: object
+    EntityToIncidents:
+      description: Entity to incidents relationship.
+      properties:
+        data:
+          $ref: '#/components/schemas/RelationshipArray'
+      type: object
+    EntityToOncalls:
+      description: Entity to oncalls relationship.
+      properties:
+        data:
+          $ref: '#/components/schemas/RelationshipArray'
+      type: object
+    EntityToRawSchema:
+      description: Entity to raw schema relationship.
+      properties:
+        data:
+          $ref: '#/components/schemas/RelationshipItem'
+      type: object
+    EntityToRelatedEntities:
+      description: Entity to related entities relationship.
+      properties:
+        data:
+          $ref: '#/components/schemas/RelationshipArray'
+      type: object
+    EntityToSchema:
+      description: Entity to detail schema relationship.
+      properties:
+        data:
+          $ref: '#/components/schemas/RelationshipItem'
+      type: object
+    EntityV3:
+      description: Entity schema v3.
+      oneOf:
+      - $ref: '#/components/schemas/EntityV3Service'
+      - $ref: '#/components/schemas/EntityV3Datastore'
+      - $ref: '#/components/schemas/EntityV3Queue'
+      - $ref: '#/components/schemas/EntityV3System'
+    EntityV3APIVersion:
+      description: The schema version of entity type. The field is known as schema-version
+        in the previous version
+      enum:
+      - v3
+      example: v3
+      type: string
+      x-enum-varnames:
+      - V3
+    EntityV3DatadogCodeLocationItem:
+      additionalProperties: false
+      description: code location item.
+      properties:
+        paths:
+          description: The paths (glob) to the source code of the service
+          items:
+            type: string
+          type: array
+        repositoryURL:
+          description: The repository path of the source code of the entity
+          pattern: url
+          type: string
+      type: object
+    EntityV3DatadogCodeLocations:
+      additionalProperties: false
+      description: Schema for mapping source code locations to an entity
+      items:
+        $ref: '#/components/schemas/EntityV3DatadogCodeLocationItem'
+      type: array
+    EntityV3DatadogEventItem:
+      additionalProperties: false
+      description: Events association item.
+      properties:
+        name:
+          description: The name of the query
+          type: string
+        query:
+          description: The query to run
+          type: string
+      type: object
+    EntityV3DatadogEvents:
+      additionalProperties: false
+      description: Events associations
+      items:
+        $ref: '#/components/schemas/EntityV3DatadogEventItem'
+      type: array
+    EntityV3DatadogIntegrationOpsgenie:
+      additionalProperties: false
+      description: An Opsgenie integration schema
+      properties:
+        region:
+          description: The region for the Opsgenie integration.
+          minLength: 1
+          type: string
+        serviceURL:
+          description: The service url for the Opsgenie integration.
+          example: https://www.opsgenie.com/service/shopping-cart
+          minLength: 1
+          type: string
+      required:
+      - serviceURL
+      type: object
+    EntityV3DatadogIntegrationPagerduty:
+      additionalProperties: false
+      description: An PagerDuty integration schema
+      properties:
+        serviceURL:
+          description: The service url for the PagerDuty integration.
+          example: https://www.pagerduty.com/service-directory/Pshopping-cart
+          minLength: 1
+          type: string
+      required:
+      - serviceURL
+      type: object
+    EntityV3DatadogLogItem:
+      additionalProperties: false
+      description: log association item.
+      properties:
+        name:
+          description: The name of the query
+          type: string
+        query:
+          description: The query to run
+          type: string
+      type: object
+    EntityV3DatadogLogs:
+      additionalProperties: false
+      description: Logs association
+      items:
+        $ref: '#/components/schemas/EntityV3DatadogLogItem'
+      type: array
+    EntityV3DatadogPerformance:
+      additionalProperties: false
+      description: Performance stats association
+      properties:
+        tags:
+          description: A list of APM entity tags that associates the APM Stats data
+            with the entity
+          items:
+            type: string
+          type: array
+      type: object
+    EntityV3DatadogPipelines:
+      additionalProperties: false
+      description: CI Pipelines association
+      properties:
+        fingerprints:
+          description: A list of CI Fingerprints that associate CI Pipelines with
+            the entity
+          items:
+            type: string
+          type: array
+      type: object
+    EntityV3Datastore:
+      additionalProperties: false
+      description: Schema for datastore entities
+      properties:
+        apiVersion:
+          $ref: '#/components/schemas/EntityV3APIVersion'
+        datadog:
+          $ref: '#/components/schemas/EntityV3DatastoreDatadog'
+        extensions:
+          additionalProperties: {}
+          description: Custom extensions. This is the free-formed field to send client
+            side metadata. No Datadog features are affected by this field.
+          type: object
+        integrations:
+          $ref: '#/components/schemas/EntityV3Integrations'
+        kind:
+          $ref: '#/components/schemas/EntityV3DatastoreKind'
+        metadata:
+          $ref: '#/components/schemas/EntityV3Metadata'
+        spec:
+          $ref: '#/components/schemas/EntityV3DatastoreSpec'
+      required:
+      - apiVersion
+      - kind
+      - metadata
+      type: object
+    EntityV3DatastoreDatadog:
+      additionalProperties: false
+      description: Datadog product integrations for the datastore entity
+      properties:
+        events:
+          $ref: '#/components/schemas/EntityV3DatadogEvents'
+        logs:
+          $ref: '#/components/schemas/EntityV3DatadogLogs'
+        performanceData:
+          $ref: '#/components/schemas/EntityV3DatadogPerformance'
+      type: object
+    EntityV3DatastoreKind:
+      description: The definition of Entity V3 Datastore Kind object.
+      enum:
+      - datastore
+      example: datastore
+      type: string
+      x-enum-varnames:
+      - DATASTORE
+    EntityV3DatastoreSpec:
+      additionalProperties: false
+      description: The definition of Entity V3 Datastore Spec object.
+      properties:
+        lifecycle:
+          description: The lifecycle state of the datastore.
+          minLength: 1
+          type: string
+        tier:
+          description: The importance of the datastore
+          minLength: 1
+          type: string
+        type:
+          description: The type of datastore
+          type: string
+      type: object
+    EntityV3Integrations:
+      additionalProperties: false
+      description: A base schema for defining third party integrations
+      properties:
+        opsgenie:
+          $ref: '#/components/schemas/EntityV3DatadogIntegrationOpsgenie'
+        pagerduty:
+          $ref: '#/components/schemas/EntityV3DatadogIntegrationPagerduty'
+      type: object
+    EntityV3Metadata:
+      additionalProperties: false
+      description: The definition of Entity V3 Metadata object.
+      properties:
+        additionalOwners:
+          additionalProperties: false
+          description: The additional owners of the entity, usually a team
+          items:
+            $ref: '#/components/schemas/EntityV3MetadataAdditionalOwnersItems'
+          type: array
+        contacts:
+          additionalProperties: false
+          description: A list of contacts for the entity
+          items:
+            $ref: '#/components/schemas/EntityV3MetadataContactsItems'
+          type: array
+        description:
+          description: Short description of the entity. The UI can leverage the description
+            for display
+          type: string
+        displayName:
+          description: User friendly name of the entity. The UI can leverage the display
+            name for display
+          type: string
+        id:
+          description: A read-only globally unique identifier for the entity generated
+            by Datadog.  User supplied values are ignored.
+          example: 4b163705-23c0-4573-b2fb-f6cea2163fcb
+          minLength: 1
+          type: string
+        inheritFrom:
+          description: The entity reference from which to inherit metadata
+          example: application:default/myapp
+          type: string
+        links:
+          additionalProperties: false
+          description: A list of links for the entity
+          items:
+            $ref: '#/components/schemas/EntityV3MetadataLinksItems'
+          type: array
+        managed:
+          additionalProperties: {}
+          description: A read-only set of Datadog managed attributes generated by
+            Datadog.  User supplied values are ignored.
+          type: object
+        name:
+          description: 'Unique name given to an entity under the kind/namespace '
+          example: myService
+          minLength: 1
+          type: string
+        namespace:
+          description: Namespace is a part of unique identifier. It has a default
+            value of 'default'
+          example: default
+          minLength: 1
+          type: string
+        owner:
+          $ref: '#/components/schemas/EntityV3MetadataOwner'
+        tags:
+          description: A set of custom tags
+          example:
+          - this:tag
+          - that:tag
+          items:
+            type: string
+          type: array
+      required:
+      - name
+      type: object
+    EntityV3MetadataAdditionalOwnersItems:
+      description: The definition of Entity V3 Metadata Additional Owners Items object.
+      properties:
+        name:
+          description: Team name
+          example: ''
+          type: string
+        type:
+          description: Team type
+          type: string
+      required:
+      - name
+    EntityV3MetadataContactsItems:
+      additionalProperties: false
+      description: The definition of Entity V3 Metadata Contacts Items object.
+      properties:
+        contact:
+          description: Contact value
+          example: https://slack/
+          type: string
+        name:
+          description: Contact name
+          minLength: 2
+          type: string
+        type:
+          description: Contact type.
+          example: slack
+          type: string
+      required:
+      - type
+      - contact
+      type: object
+    EntityV3MetadataLinksItems:
+      additionalProperties: false
+      description: The definition of Entity V3 Metadata Links Items object.
+      properties:
+        name:
+          description: Link name
+          example: mylink
+          type: string
+        provider:
+          description: Link provider.
+          type: string
+        type:
+          default: other
+          description: Link type.
+          example: link
+          type: string
+        url:
+          description: Link url
+          example: https://mylink
+          type: string
+      required:
+      - name
+      - type
+      - url
+      type: object
+    EntityV3MetadataOwner:
+      additionalProperties: false
+      description: The owner of the entity, usually a team
+      properties:
+        name:
+          description: Team name
+          type: string
+    EntityV3Queue:
+      additionalProperties: false
+      description: Schema for queue entities
+      properties:
+        apiVersion:
+          $ref: '#/components/schemas/EntityV3APIVersion'
+        datadog:
+          $ref: '#/components/schemas/EntityV3QueueDatadog'
+        extensions:
+          additionalProperties: {}
+          description: Custom extensions. This is the free-formed field to send client
+            side metadata. No Datadog features are affected by this field.
+          type: object
+        integrations:
+          $ref: '#/components/schemas/EntityV3Integrations'
+        kind:
+          $ref: '#/components/schemas/EntityV3QueueKind'
+        metadata:
+          $ref: '#/components/schemas/EntityV3Metadata'
+        spec:
+          $ref: '#/components/schemas/EntityV3QueueSpec'
+      required:
+      - apiVersion
+      - kind
+      - metadata
+      type: object
+    EntityV3QueueDatadog:
+      additionalProperties: false
+      description: Datadog product integrations for the datastore entity
+      properties:
+        events:
+          $ref: '#/components/schemas/EntityV3DatadogEvents'
+        logs:
+          $ref: '#/components/schemas/EntityV3DatadogLogs'
+        performanceData:
+          $ref: '#/components/schemas/EntityV3DatadogPerformance'
+      type: object
+    EntityV3QueueKind:
+      description: The definition of Entity V3 Queue Kind object.
+      enum:
+      - queue
+      example: queue
+      type: string
+      x-enum-varnames:
+      - QUEUE
+    EntityV3QueueSpec:
+      additionalProperties: false
+      description: The definition of Entity V3 Queue Spec object.
+      properties:
+        lifecycle:
+          description: The lifecycle state of the queue.
+          minLength: 1
+          type: string
+        tier:
+          description: The importance of the queue
+          minLength: 1
+          type: string
+        type:
+          description: The type of queue
+          type: string
+      type: object
+    EntityV3Service:
+      additionalProperties: false
+      description: Schema for service entities
+      properties:
+        apiVersion:
+          $ref: '#/components/schemas/EntityV3APIVersion'
+        datadog:
+          $ref: '#/components/schemas/EntityV3ServiceDatadog'
+        extensions:
+          additionalProperties: {}
+          description: Custom extensions. This is the free-formed field to send client
+            side metadata. No Datadog features are affected by this field.
+          type: object
+        integrations:
+          $ref: '#/components/schemas/EntityV3Integrations'
+        kind:
+          $ref: '#/components/schemas/EntityV3ServiceKind'
+        metadata:
+          $ref: '#/components/schemas/EntityV3Metadata'
+        spec:
+          $ref: '#/components/schemas/EntityV3ServiceSpec'
+      required:
+      - apiVersion
+      - kind
+      - metadata
+      type: object
+    EntityV3ServiceDatadog:
+      additionalProperties: false
+      description: Datadog product integrations for the service entity
+      properties:
+        codeLocations:
+          $ref: '#/components/schemas/EntityV3DatadogCodeLocations'
+        events:
+          $ref: '#/components/schemas/EntityV3DatadogEvents'
+        logs:
+          $ref: '#/components/schemas/EntityV3DatadogLogs'
+        performanceData:
+          $ref: '#/components/schemas/EntityV3DatadogPerformance'
+        pipelines:
+          $ref: '#/components/schemas/EntityV3DatadogPipelines'
+      type: object
+    EntityV3ServiceKind:
+      description: The definition of Entity V3 Service Kind object.
+      enum:
+      - service
+      example: service
+      type: string
+      x-enum-varnames:
+      - SERVICE
+    EntityV3ServiceSpec:
+      additionalProperties: false
+      description: The definition of Entity V3 Service Spec object.
+      properties:
+        dependsOn:
+          description: A list of components the service depends on
+          items:
+            type: string
+          type: array
+        languages:
+          description: The service's programming language.
+          items:
+            type: string
+          type: array
+        lifecycle:
+          description: The lifecycle state of the component.
+          minLength: 1
+          type: string
+        tier:
+          description: The importance of the component
+          minLength: 1
+          type: string
+        type:
+          description: The type of service
+          type: string
+      type: object
+    EntityV3System:
+      additionalProperties: false
+      description: Schema for system entities
+      properties:
+        apiVersion:
+          $ref: '#/components/schemas/EntityV3APIVersion'
+        datadog:
+          $ref: '#/components/schemas/EntityV3SystemDatadog'
+        extensions:
+          additionalProperties: {}
+          description: Custom extensions. This is the free-formed field to send client
+            side metadata. No Datadog features are affected by this field.
+          type: object
+        integrations:
+          $ref: '#/components/schemas/EntityV3Integrations'
+        kind:
+          $ref: '#/components/schemas/EntityV3SystemKind'
+        metadata:
+          $ref: '#/components/schemas/EntityV3Metadata'
+        spec:
+          $ref: '#/components/schemas/EntityV3SystemSpec'
+      required:
+      - apiVersion
+      - kind
+      - metadata
+      type: object
+    EntityV3SystemDatadog:
+      additionalProperties: false
+      description: Datadog product integrations for the service entity
+      properties:
+        events:
+          $ref: '#/components/schemas/EntityV3DatadogEvents'
+        logs:
+          $ref: '#/components/schemas/EntityV3DatadogLogs'
+        performanceData:
+          $ref: '#/components/schemas/EntityV3DatadogPerformance'
+        pipelines:
+          $ref: '#/components/schemas/EntityV3DatadogPipelines'
+      type: object
+    EntityV3SystemKind:
+      description: The definition of Entity V3 System Kind object.
+      enum:
+      - system
+      example: system
+      type: string
+      x-enum-varnames:
+      - SYSTEM
+    EntityV3SystemSpec:
+      additionalProperties: false
+      description: The definition of Entity V3 System Spec object.
+      properties:
+        components:
+          description: A list of components belongs to the system.
+          items:
+            type: string
+          type: array
+        lifecycle:
+          description: The lifecycle state of the component.
+          minLength: 1
+          type: string
+        tier:
+          description: An entity reference to the owner of the component.
+          minLength: 1
+          type: string
+      type: object
     Event:
       description: The metadata associated with a request.
       properties:
@@ -8155,6 +9047,9 @@ components:
           description: The API key of the Fastly account.
           example: ABCDEFG123
           type: string
+        name:
+          description: The name of the Fastly account.
+          type: string
       type: object
     FastlyAccountUpdateRequestData:
       description: Data object for updating a Fastly account.
@@ -8451,6 +9346,7 @@ components:
         created_at:
           description: Creation date of the API key.
           example: '2020-11-23T10:00:00.000Z'
+          format: date-time
           readOnly: true
           type: string
         key:
@@ -8467,6 +9363,7 @@ components:
         modified_at:
           description: Date the API key was last modified.
           example: '2020-11-23T10:00:00.000Z'
+          format: date-time
           readOnly: true
           type: string
         name:
@@ -9384,6 +10281,19 @@ components:
             were created or updated by the request are
 
             returned.'
+          example:
+          - attributes:
+              attachment:
+                documentUrl: ''
+                title: Postmortem IR-123
+              attachment_type: postmortem
+            id: 00000000-abcd-0002-0000-000000000000
+            relationships:
+              last_modified_by_user:
+                data:
+                  id: 00000000-0000-0000-cccc-000000000000
+                  type: users
+            type: incident_attachments
           items:
             $ref: '#/components/schemas/IncidentAttachmentData'
           type: array
@@ -9415,6 +10325,19 @@ components:
       properties:
         data:
           description: An array of incident attachments.
+          example:
+          - attributes:
+              attachment:
+                documentUrl: ''
+                title: Postmortem IR-123
+              attachment_type: postmortem
+            id: 00000000-abcd-0002-0000-000000000000
+            relationships:
+              last_modified_by_user:
+                data:
+                  id: 00000000-0000-0000-cccc-000000000000
+                  type: users
+            type: incident_attachments
           items:
             $ref: '#/components/schemas/IncidentAttachmentData'
           type: array
@@ -9508,8 +10431,6 @@ components:
       oneOf:
       - $ref: '#/components/schemas/IncidentFieldAttributesSingleValue'
       - $ref: '#/components/schemas/IncidentFieldAttributesMultipleValue'
-      required:
-      - type
     IncidentFieldAttributesMultipleValue:
       description: A field with potentially multiple values selected.
       properties:
@@ -10626,6 +11547,8 @@ components:
       - $ref: '#/components/schemas/IncidentTodoAnonymousAssignee'
     IncidentTodoAssigneeArray:
       description: Array of todo assignees.
+      example:
+      - '@test.user@test.com'
       items:
         $ref: '#/components/schemas/IncidentTodoAssignee'
       type: array
@@ -10986,6 +11909,21 @@ components:
       required:
       - data
       type: object
+    IncludeType:
+      description: supported include types.
+      enum:
+      - schema
+      - raw_schema
+      - oncall
+      - incident
+      - relation
+      type: string
+      x-enum-varnames:
+      - SCHEMA
+      - RAW_SCHEMA
+      - ONCALL
+      - INCIDENT
+      - RELATION
     IntakePayloadAccepted:
       description: The payload accepted for intake.
       properties:
@@ -11130,6 +12068,45 @@ components:
           description: Jira project key
           type: string
       type: object
+    LeakedKey:
+      description: The definition of LeakedKey object.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/LeakedKeyAttributes'
+        id:
+          description: The LeakedKey id.
+          example: id
+          type: string
+        type:
+          $ref: '#/components/schemas/LeakedKeyType'
+      required:
+      - attributes
+      - id
+      - type
+      type: object
+    LeakedKeyAttributes:
+      description: The definition of LeakedKeyAttributes object.
+      properties:
+        date:
+          description: The LeakedKeyAttributes date.
+          example: '2017-07-21T17:32:28Z'
+          format: date-time
+          type: string
+        leak_source:
+          description: The LeakedKeyAttributes leak_source.
+          type: string
+      required:
+      - date
+      type: object
+    LeakedKeyType:
+      default: leaked_keys
+      description: The definition of LeakedKeyType object.
+      enum:
+      - leaked_keys
+      example: leaked_keys
+      type: string
+      x-enum-varnames:
+      - LEAKED_KEYS
     ListAPIsResponse:
       description: Response for `ListAPIs`.
       properties:
@@ -11240,6 +12217,44 @@ components:
         meta:
           $ref: '#/components/schemas/DowntimeMeta'
       type: object
+    ListEntityCatalogResponse:
+      description: List entity response.
+      properties:
+        data:
+          $ref: '#/components/schemas/EntityResponseData'
+        included:
+          $ref: '#/components/schemas/ListEntityCatalogResponseIncluded'
+        links:
+          $ref: '#/components/schemas/ListEntityCatalogResponseLinks'
+        meta:
+          $ref: '#/components/schemas/EntityResponseMeta'
+      type: object
+    ListEntityCatalogResponseIncluded:
+      description: List entity response included.
+      items:
+        $ref: '#/components/schemas/ListEntityCatalogResponseIncludedItem'
+      type: array
+    ListEntityCatalogResponseIncludedItem:
+      description: List entity response included item.
+      oneOf:
+      - $ref: '#/components/schemas/EntityResponseIncludedSchema'
+      - $ref: '#/components/schemas/EntityResponseIncludedRawSchema'
+      - $ref: '#/components/schemas/EntityResponseIncludedRelatedEntity'
+      - $ref: '#/components/schemas/EntityResponseIncludedOncall'
+      - $ref: '#/components/schemas/EntityResponseIncludedIncident'
+    ListEntityCatalogResponseLinks:
+      description: List entity response links.
+      properties:
+        next:
+          description: next link.
+          type: string
+        previous:
+          description: previous link.
+          type: string
+        self:
+          description: current link.
+          type: string
+      type: object
     ListFindingsData:
       description: Array of findings.
       items:
@@ -11743,9 +12758,6 @@ components:
       - $ref: '#/components/schemas/LogsArchiveDestinationAzure'
       - $ref: '#/components/schemas/LogsArchiveDestinationGCS'
       - $ref: '#/components/schemas/LogsArchiveDestinationS3'
-      required:
-      - type
-      - integration
     LogsArchiveDefinition:
       description: The definition of an archive.
       properties:
@@ -11772,9 +12784,7 @@ components:
       - $ref: '#/components/schemas/LogsArchiveDestinationAzure'
       - $ref: '#/components/schemas/LogsArchiveDestinationGCS'
       - $ref: '#/components/schemas/LogsArchiveDestinationS3'
-      required:
-      - type
-      - integration
+      type: object
     LogsArchiveDestinationAzure:
       description: The Azure archive destination.
       properties:
@@ -12569,11 +13579,14 @@ components:
       readOnly: true
       type: object
     MetricAssetAttributes:
-      description: Assets where only included attribute is its title
+      description: Assets related to the object, including title and url.
       properties:
         title:
           description: Title of the asset.
           type: string
+        url:
+          description: URL path of the asset.
+          type: string
       type: object
     MetricAssetDashboardRelationship:
       description: An object of type `dashboard` that can be referenced in the `included`
@@ -12781,7 +13794,6 @@ components:
       - bob@example.com
       items:
         description: An email address.
-        format: email
         type: string
       type: array
     MetricBulkTagConfigNamePrefix:
@@ -12953,7 +13965,8 @@ components:
       - type
       type: object
     MetricDashboardAttributes:
-      description: Attributes related to the dashboard, including title and popularity.
+      description: Attributes related to the dashboard, including title, popularity,
+        and url.
       properties:
         popularity:
           description: Value from 0 to 5 that ranks popularity of the dashboard.
@@ -12964,6 +13977,9 @@ components:
         title:
           description: Title of the asset.
           type: string
+        url:
+          description: URL path of the asset.
+          type: string
       type: object
     MetricDashboardID:
       description: The related dashboard's ID.
@@ -13291,6 +14307,9 @@ components:
             timestamp and a scalar value (cannot be a string). Timestamps should be
             in POSIX time in seconds, and cannot be more than ten minutes in the future
             or more than one hour in the past.
+          example:
+          - timestamp: 1575317847
+            value: 0.5
           items:
             $ref: '#/components/schemas/MetricPoint'
           type: array
@@ -14297,6 +15316,7 @@ components:
         name:
           description: The name for the Opsgenie service.
           example: fake-opsgenie-service-name
+          maxLength: 100
           type: string
         opsgenie_api_key:
           description: The Opsgenie API key for your Opsgenie service.
@@ -14359,6 +15379,7 @@ components:
         name:
           description: The name for the Opsgenie service.
           example: fake-opsgenie-service-name
+          maxLength: 100
           type: string
         region:
           $ref: '#/components/schemas/OpsgenieServiceRegionType'
@@ -14371,6 +15392,8 @@ components:
         id:
           description: The ID of the Opsgenie service.
           example: 596da4af-0563-4097-90ff-07230c3f9db3
+          maxLength: 100
+          minLength: 1
           type: string
         type:
           $ref: '#/components/schemas/OpsgenieServiceType'
@@ -14399,6 +15422,7 @@ components:
         name:
           description: The name for the Opsgenie service.
           example: fake-opsgenie-service-name
+          maxLength: 100
           type: string
         opsgenie_api_key:
           description: The Opsgenie API key for your Opsgenie service.
@@ -14415,6 +15439,8 @@ components:
         id:
           description: The ID of the Opsgenie service.
           example: 596da4af-0563-4097-90ff-07230c3f9db3
+          maxLength: 100
+          minLength: 1
           type: string
         type:
           $ref: '#/components/schemas/OpsgenieServiceType'
@@ -16305,6 +17331,46 @@ components:
             from the other indexes
           type: string
       type: object
+    RelationType:
+      description: supported relation types
+      enum:
+      - RelationTypeOwns
+      - RelationTypeOwnedBy
+      - RelationTypeDependsOn
+      - RelationTypeDependencyOf
+      - RelationTypePartsOf
+      - RelationTypeHasPart
+      - RelationTypeOtherOwns
+      - RelationTypeOtherOwnedBy
+      - RelationTypeImplementedBy
+      - RelationTypeImplements
+      type: string
+      x-enum-varnames:
+      - RELATIONTYPEOWNS
+      - RELATIONTYPEOWNEDBY
+      - RELATIONTYPEDEPENDSON
+      - RELATIONTYPEDEPENDENCYOF
+      - RELATIONTYPEPARTSOF
+      - RELATIONTYPEHASPART
+      - RELATIONTYPEOTHEROWNS
+      - RELATIONTYPEOTHEROWNEDBY
+      - RELATIONTYPEIMPLEMENTEDBY
+      - RELATIONTYPEIMPLEMENTS
+    RelationshipArray:
+      description: Relationships.
+      items:
+        $ref: '#/components/schemas/RelationshipItem'
+      type: array
+    RelationshipItem:
+      description: Relationship entry.
+      properties:
+        id:
+          description: Associated data id.
+          type: string
+        type:
+          description: Relationship type.
+          type: string
+      type: object
     RelationshipToIncidentAttachment:
       description: A relationship reference for attachments.
       properties:
@@ -17632,6 +18698,10 @@ components:
       type: object
     ScalarFormulaRequestQueries:
       description: List of queries to be run and used as inputs to the formulas.
+      example:
+      - aggregator: avg
+        data_source: metrics
+        query: avg:system.cpu.user{*} by {env}
       items:
         $ref: '#/components/schemas/ScalarQuery'
       type: array
@@ -18590,6 +19660,8 @@ components:
       type: object
     SecurityMonitoringSignalIncidentIds:
       description: Array of incidents that are associated with this signal.
+      example:
+      - 2066
       items:
         description: Public ID attribute of the incident that is associated with the
           signal.
@@ -19497,6 +20569,10 @@ components:
           description: A description for the suppression rule.
           example: This rule suppresses low-severity signals in staging environments.
           type: string
+        editable:
+          description: Whether the suppression rule is editable.
+          example: true
+          type: boolean
         enabled:
           description: Whether the suppression rule is enabled.
           example: true
@@ -20592,7 +21668,6 @@ components:
       - $ref: '#/components/schemas/ServiceDefinitionV2'
       - $ref: '#/components/schemas/ServiceDefinitionV2Dot1'
       - $ref: '#/components/schemas/ServiceDefinitionV2Dot2'
-      type: object
     ServiceDefinitionSchemaVersions:
       description: Schema versions
       enum:
@@ -20650,7 +21725,6 @@ components:
         email:
           description: "Service owner\u2019s email."
           example: contact@datadoghq.com
-          format: email
           type: string
         slack:
           description: "Service owner\u2019s Slack channel."
@@ -20911,7 +21985,6 @@ components:
         contact:
           description: Contact value.
           example: contact@datadoghq.com
-          format: email
           type: string
         name:
           description: Contact email.
@@ -21272,7 +22345,6 @@ components:
         contact:
           description: Contact value.
           example: contact@datadoghq.com
-          format: email
           type: string
         name:
           description: Contact email.
@@ -22656,7 +23728,6 @@ components:
         url:
           description: The URL for the link
           example: https://example.com
-          format: url
           type: string
       required:
       - label
@@ -23109,6 +24180,9 @@ components:
       type: object
     TimeseriesFormulaRequestQueries:
       description: List of queries to be run and used as inputs to the formulas.
+      example:
+      - data_source: metrics
+        query: avg:system.cpu.user{*} by {env}
       items:
         $ref: '#/components/schemas/TimeseriesQuery'
       type: array
@@ -23299,6 +24373,30 @@ components:
         type:
           $ref: '#/components/schemas/RuleType'
       type: object
+    UpsertCatalogEntityRequest:
+      description: Create / Update entity request.
+      oneOf:
+      - $ref: '#/components/schemas/EntityV3'
+      - $ref: '#/components/schemas/EntityRaw'
+    UpsertCatalogEntityResponse:
+      description: Upsert entity response.
+      properties:
+        data:
+          $ref: '#/components/schemas/EntityResponseData'
+        included:
+          $ref: '#/components/schemas/UpsertCatalogEntityResponseIncluded'
+        meta:
+          $ref: '#/components/schemas/EntityResponseMeta'
+      type: object
+    UpsertCatalogEntityResponseIncluded:
+      description: Upsert entity response included.
+      items:
+        $ref: '#/components/schemas/UpsertCatalogEntityResponseIncludedItem'
+      type: array
+    UpsertCatalogEntityResponseIncludedItem:
+      description: Upsert entity response included item.
+      oneOf:
+      - $ref: '#/components/schemas/EntityResponseIncludedSchema'
     UsageApplicationSecurityMonitoringResponse:
       description: Application Security Monitoring usage response.
       properties:
@@ -24041,6 +25139,7 @@ components:
               access to the cloud cost data source in dashboards and notebooks.
             cloud_cost_management_write: Configure cloud cost accounts and global
               customizations.
+            code_analysis_read: View Code Analysis.
             continuous_profiler_pgo_read: Read and query Continuous Profiler data
               for Profile-Guided Optimization (PGO).
             create_webhooks: Create webhooks integrations.
@@ -25789,6 +26888,109 @@ paths:
       summary: Unassign case
       tags:
       - Case Management
+  /api/v2/catalog/entity:
+    get:
+      description: Get a list of entities from Software Catalog.
+      operationId: ListCatalogEntity
+      parameters:
+      - $ref: '#/components/parameters/PageOffset'
+      - description: Maximum number of entities in the response.
+        example: 100
+        in: query
+        name: page[limit]
+        required: false
+        schema:
+          default: 100
+          format: int64
+          type: integer
+      - $ref: '#/components/parameters/FilterByID'
+      - $ref: '#/components/parameters/FilterByRef'
+      - $ref: '#/components/parameters/FilterByName'
+      - $ref: '#/components/parameters/FilterByKind'
+      - $ref: '#/components/parameters/FilterByOwner'
+      - $ref: '#/components/parameters/FilterByRelationType'
+      - $ref: '#/components/parameters/FilterByExcludeSnapshot'
+      - $ref: '#/components/parameters/Include'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ListEntityCatalogResponse'
+          description: OK
+        '403':
+          $ref: '#/components/responses/ForbiddenResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - apm_service_catalog_read
+      summary: Get a list of entities
+      tags:
+      - Software Catalog
+      x-pagination:
+        limitParam: page[limit]
+        pageParam: page[offset]
+        resultsPath: data
+    post:
+      description: Create or update entities in Software Catalog.
+      operationId: UpsertCatalogEntity
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/UpsertCatalogEntityRequest'
+        description: Entity YAML/JSON.
+        required: true
+      responses:
+        '202':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UpsertCatalogEntityResponse'
+          description: ACCEPTED
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/ForbiddenResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - apm_service_catalog_write
+      summary: Create or update entities
+      tags:
+      - Software Catalog
+      x-codegen-request-body-name: body
+  /api/v2/catalog/entity/{entity_id}:
+    delete:
+      description: Delete a single entity in Software Catalog.
+      operationId: DeleteCatalogEntity
+      parameters:
+      - $ref: '#/components/parameters/EntityID'
+      responses:
+        '204':
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/ForbiddenResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - apm_service_catalog_write
+      summary: Delete a single entity
+      tags:
+      - Software Catalog
   /api/v2/ci/pipeline:
     post:
       description: 'Send your pipeline event to your Datadog platform over HTTP. For
@@ -27676,13 +28878,13 @@ paths:
         required: false
         schema:
           type: string
-      - description: Minimum timestamp for requested events.
+      - description: Minimum timestamp for requested events, in milliseconds.
         in: query
         name: filter[from]
         required: false
         schema:
           type: string
-      - description: Maximum timestamp for requested events.
+      - description: Maximum timestamp for requested events, in milliseconds.
         in: query
         name: filter[to]
         required: false
@@ -32609,11 +33811,11 @@ paths:
 
         - Service Level Objectives: `slo`
 
-        - Synthetic Global Variables: `synthetic-global-variable`
+        - Synthetic Global Variables: `synthetics-global-variable`
 
-        - Synthetic Tests: `synthetic-test`
+        - Synthetic Tests: `synthetics-test`
 
-        - Synthetic Private Locations: `synthetic-private-location`
+        - Synthetic Private Locations: `synthetics-private-location`
 
         - Monitors: `monitor`
 
@@ -38340,8 +39542,10 @@ tags:
     for more information.
   name: Case Management
 - description: The Cloud Cost Management API allows you to set up, edit, and delete
-    Cloud Cost Management accounts for AWS and Azure. See the [Cloud Cost Management
-    page](https://docs.datadoghq.com/cloud_cost_management/) for more information.
+    Cloud Cost Management accounts for AWS and Azure. You can query your cost data
+    by using the [Metrics endpoint](https://docs.datadoghq.com/api/latest/metrics/#query-timeseries-data-across-multiple-products)
+    and the `cloud_cost` data source. For more information, see the [Cloud Cost Management
+    documentation](https://docs.datadoghq.com/cloud_cost_management/).
   name: Cloud Cost Management
 - description: Manage your Datadog Cloudflare integration directly through the Datadog
     API. See the [Cloudflare integration page](https://docs.datadoghq.com/integrations/cloudflare/)
@@ -38595,6 +39799,10 @@ tags:
     This feature is currently in BETA. If you have any feedback, contact [Datadog
     support](https://docs.datadoghq.com/help/).'
   name: Service Scorecards
+- description: API to create, update, retrieve and delete Software Catalog entities.
+  externalDocs:
+    url: https://docs.datadoghq.com/service_catalog/service_definitions#metadata-schema-v30-beta
+  name: Software Catalog
 - description: Search and aggregate your spans from your Datadog platform over HTTP.
   name: Spans
 - description: Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics)