---
title: "Delete External Demand"
method: DELETE
path: "/api/v2/resource_management/ext-systems/resourcing/ext-demands/{extDemandId}"
tags: ["Ext Demand"]
---

# Delete External Demand

`DELETE /api/v2/resource_management/ext-systems/resourcing/ext-demands/{extDemandId}`

## Request

- Base URL: `https://apiv2.eightfold.ai`
- URL: `https://apiv2.eightfold.ai/api/v2/resource_management/ext-systems/resourcing/ext-demands/{extDemandId}`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/eightfold/apis/api-server-v2-service-service/docs/api/v2/resource_management/ext-systems/resourcing/ext-demands/:extDemandId/delete.ts> (a function with typed inputs; its response is checked against the schema)

Deletes external demand given its id.

## Path parameters

- `extDemandId` string, required

## Headers

- `Authorization` string, required

## Response `200`

OK

- ExtDemandDataSchema
  - `createdAt` integer, nullable, required: creation timestamp in epoch format
  - `locationCountry` string, nullable: location country
  - `workLocationOption` string, nullable: Indicates the option for working location e.g. onsite, remote_global, remote_local, hybrid
  - `skillDetails` ATSSkillDetail[], nullable: skill details of the demand
    - `skillGroups` ATSSkillGroup[], nullable: Skill groups
      - `proficiency` string, nullable: Proficiency
      - `skillGroup` string, nullable: Skill Group
    - `proficiency` string, nullable: Proficiency. Note: proficiency must be specified only for each skill group when skill groups are present
    - `evaluationTimestamp` integer, nullable: Evaluation timestamp
    - `dataSource` string, nullable: Data source of the skill
    - `skill` string, nullable: Skill
  - `demandManager` PersonSchema
    - `email` string, nullable: email
    - `name` string, nullable, required: Name
  - `skills` string[], nullable: skills
  - `locationCity` string, nullable: location city
  - `lastUpdated` integer, nullable, required: last modified date time in epoch format
  - `demandBand` string, nullable: Demand Band
  - `rmUserGroups` RmUserGroup[], nullable: User groups associated with the demand
    - `userGroupId` string, nullable: Unique identifier for the user group
  - `openings` ExtDemandOpeningsData
    - `numOpenings` integer, nullable, required: Number of openings
    - `numOpeningsFilled` integer, nullable: Number of openings filled
  - `publishSettings` DemandPublishSettingsSchema
    - `publishMode` string, nullable: Publish mode (local, custom, local_and_custom)
    - `publishedToUserGroups` RmUserGroup[], nullable: User groups the demand is published to
      - `userGroupId` string, nullable: Unique identifier for the user group
  - `followers` PersonSchema[], nullable: all the followers of the demand such as resource manager etc.
    - `email` string, nullable: email
    - `name` string, nullable, required: Name
  - `restrictAccess` boolean, nullable: restrict access
  - `tags` ExtEntityTag[]: Tags associated with the demand
    - `type` 'user' | 'system', required: Type of the tag (user/system)
    - `name` string, required: Name of the tag
  - `title` string, nullable, required: demand title
  - `demandOrgUnits` ExtDemandOrgUnitsData
    - `programId` string, nullable: Program id
    - `projectId` string, nullable, required: Project id
  - `demandId` integer, nullable: Internal demand ID
  - `locationFlexibility` string, nullable: Indicates the flexibility on location e.g. not_flexible, flexible_within_country, flexible_global
  - `extDemandId` string, nullable, required: demand id in the external system
  - `maxExperience` integer, nullable: Maximum experience in years
  - `customFields` object, nullable: custom fields
  - `resourceManager` PersonSchema
    - `email` string, nullable: email
    - `name` string, nullable, required: Name
  - `workflowTemplateId` string, nullable: Indicates which workflow this demand belongs to
  - `displayDemandId` string, nullable: display demand id
  - `open` boolean, nullable, required: status of the demand: open or not
  - `minExperience` integer, nullable: Minimum experience in years
  - `requiredSkills` string[], nullable: required skills
  - `locationState` string, nullable: location state
  - `demandCode` string, nullable: Demand Code
  - `locations` string[], nullable: locations
  - `description` string, nullable: demand description

---

[API](https://skmtc.dev/eightfold/apis/api-server-v2-service-service.md) - [All operations](https://skmtc.dev/eightfold/apis/api-server-v2-service-service/llms.txt) - [OpenAPI document](https://skmtc.dev/eightfold/apis/api-server-v2-service-service/revisions/9a8b3a927e93?raw)