Scout RFP (Workday Strategic Sourcing) supplier_groups API
Use the supplier groups API to create, update, and query the supplier groups in Workday Strategic Sourcing. ## Supplier Group Object
Use the supplier groups API to create, update, and query the supplier groups in Workday Strategic Sourcing. ## Supplier Group Object
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/scoutrfp-supplier-groups-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Workday Strategic Sourcing attachments Supplier Groups API
version: '1.0'
description: '<span id="section/Authentication/api_key" data-section-id="section/Authentication/api_key"></span>
<span id="section/Authentication/user_token" data-section-id="section/Authentication/user_token"></span>
<span id="section/Authentication/user_email" data-section-id="section/Authentication/user_email"></span>
'
servers:
- url: https://api.us.workdayspend.com/services/attachments/v1
description: Production Server
- url: https://api.sandbox.us.workdayspend.com/services/attachments/v1
description: Sandbox Server
security:
- api_key: []
user_token: []
user_email: []
tags:
- name: supplier_groups
x-displayName: Supplier Groups
description: 'Use the supplier groups API to create, update, and query the supplier groups in Workday Strategic Sourcing.
## Supplier Group Object
<SchemaDefinition schemaRef="#/components/schemas/SupplierGroup" showReadOnly={true} showWriteOnly={true} />
'
paths:
/supplier_groups:
get:
tags:
- supplier_groups
description: Returns a list of supplier groups.
operationId: List Supplier Groups
summary: List Supplier Groups
responses:
'200':
description: OK
content:
application/vnd.api+json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/SupplierGroup'
examples:
success:
$ref: '#/components/examples/index_response-9'
'401':
description: Unauthorized
x-codeSamples:
- label: Curl
source: "curl -H \"X-Api-Key: ${COMPANY_KEY}\" \\\n -H \"X-User-Token: ${USER_TOKEN}\" \\\n -H \"X-User-Email: ${USER_EMAIL}\" \\\n -H \"Content-Type: application/vnd.api+json\" \\\n \"https://api.us.workdayspend.com/services/suppliers/v1/supplier_groups\"\n"
post:
tags:
- supplier_groups
description: 'Create a supplier group with given parameters.
'
operationId: Create a Supplier Group
summary: Create a Supplier Group
requestBody:
content:
application/vnd.api+json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/SupplierGroupCreate'
examples:
success:
$ref: '#/components/examples/create_request-8'
responses:
'201':
description: OK
content:
application/vnd.api+json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/SupplierGroup'
examples:
success:
$ref: '#/components/examples/create_response-9'
'401':
description: Unauthorized
x-codeSamples:
- label: Curl
source: "curl -H \"X-Api-Key: ${COMPANY_KEY}\" \\\n -H \"X-User-Token: ${USER_TOKEN}\" \\\n -H \"X-User-Email: ${USER_EMAIL}\" \\\n -H \"Content-Type: application/vnd.api+json\" \\\n -X POST \\\n -d '{\"data\":{\"type\":\"supplier_groups\",\"attributes\":{\"name\":\"Supplier Group\"}}' \\\n \"https://api.us.workdayspend.com/services/suppliers/v1/supplier_groups\"\n"
/supplier_groups/{id}:
patch:
tags:
- supplier_groups
description: 'Updates the details of an existing supplier group. You need to supply the unique
identifier that was returned upon supplier group creation.
Please note, that request body must include an `id` attribute with the value of your supplier group
unique identifier (the same one you passed in the URL).
'
operationId: Update a Supplier Group
summary: Update a Supplier Group
parameters:
- name: id
in: path
description: Unique supplier group identifier.
required: true
schema:
type: integer
example: 1
requestBody:
content:
application/vnd.api+json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/SupplierGroupUpdate'
examples:
success:
$ref: '#/components/examples/update_request-9'
responses:
'200':
description: OK
content:
application/vnd.api+json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/SupplierGroup'
examples:
success:
$ref: '#/components/examples/update_response-9'
'401':
description: Unauthorized
'404':
description: Not Found
'409':
description: Conflict
content:
application/vnd.api+json:
schema:
$ref: '#/components/schemas/Errors'
examples:
invalid_type:
summary: Missing or invalid 'type' specified, expected 'supplier_groups'
description: 'Returns error due to invalid `type` parameter.
'
value:
errors:
- detail: Missing or invalid 'type' specified, expected 'supplier_groups'
x-codeSamples:
- label: Curl
source: "curl -H \"X-Api-Key: ${COMPANY_KEY}\" \\\n -H \"X-User-Token: ${USER_TOKEN}\" \\\n -H \"X-User-Email: ${USER_EMAIL}\" \\\n -H \"Content-Type: application/vnd.api+json\" \\\n -X PATCH \\\n -d '{\"data\":{\"type\":\"supplier_groups\",\"id\":\"2\",\"attributes\":{\"name\":\"Updated Supplier Group\"}}}' \\\n \"https://api.us.workdayspend.com/services/suppliers/v1/supplier_groups/2\"\n"
delete:
tags:
- supplier_groups
description: 'Deletes a supplier group. You need to supply the unique supplier group
identifier that was returned upon supplier group creation.
'
operationId: Delete a Supplier Group
summary: Delete a Supplier Group
parameters:
- name: id
in: path
description: Unique supplier group identifier.
required: true
schema:
type: integer
example: 1
responses:
'204':
description: OK
'401':
description: Unauthorized
'404':
description: Not Found
x-codeSamples:
- label: Curl
source: "curl -H \"X-Api-Key: ${COMPANY_KEY}\" \\\n -H \"X-User-Token: ${USER_TOKEN}\" \\\n -H \"X-User-Email: ${USER_EMAIL}\" \\\n -H \"Content-Type: application/vnd.api+json\" \\\n -X DELETE \\\n \"https://api.us.workdayspend.com/services/suppliers/v1/supplier_groups/1\"\n"
/supplier_groups/{external_id}/external_id:
patch:
tags:
- supplier_groups
description: 'Updates the details of an existing supplier group. You need to supply the unique
external identifier assigned to the supplier group on creation.
Please note, that request body must include an `id` attribute with the value of your supplier group
unique identifier (the same one you passed in the URL).
'
operationId: Update a Supplier Group by External ID
summary: Update a Supplier Group by External ID
parameters:
- name: external_id
in: path
description: Unique supplier group external identifier.
required: true
schema:
type: string
example: SUPGROUP
requestBody:
content:
application/vnd.api+json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/SupplierGroupUpdate'
examples:
success:
$ref: '#/components/examples/external_update_request-6'
responses:
'200':
description: OK
content:
application/vnd.api+json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/SupplierGroup'
examples:
success:
$ref: '#/components/examples/external_update_response-6'
'401':
description: Unauthorized
'404':
description: Not Found
x-codeSamples:
- label: Curl
source: "curl -H \"X-Api-Key: ${COMPANY_KEY}\" \\\n -H \"X-User-Token: ${USER_TOKEN}\" \\\n -H \"X-User-Email: ${USER_EMAIL}\" \\\n -H \"Content-Type: application/vnd.api+json\" \\\n -X PATCH \\\n -d '{\"data\":{\"type\":\"supplier_groups\",\"id\":\"SUPGROUP\",\"attributes\":{\"name\":\"Updated Supplier Group\"}}}' \\\n \"https://api.us.workdayspend.com/services/suppliers/v1/supplier_groups/SUPGROUP/external_id\"\n"
delete:
tags:
- supplier_groups
description: 'Deletes a supplier group. You need to supply the unique supplier group
external identifier assigned to the supplier group on creation.
'
operationId: Delete a Supplier Group by External ID
summary: Delete a Supplier Group by External ID
parameters:
- name: external_id
in: path
description: Unique supplier group external identifier.
required: true
schema:
type: string
example: SUPGROUP
responses:
'204':
description: OK
'401':
description: Unauthorized
'404':
description: Not Found
x-codeSamples:
- label: Curl
source: "curl -H \"X-Api-Key: ${COMPANY_KEY}\" \\\n -H \"X-User-Token: ${USER_TOKEN}\" \\\n -H \"X-User-Email: ${USER_EMAIL}\" \\\n -H \"Content-Type: application/vnd.api+json\" \\\n -X DELETE \\\n \"https://api.us.workdayspend.com/services/suppliers/v1/supplier_groups/SUPGROUP/external_id\"\n"
components:
schemas:
Error:
type: object
properties:
detail:
type: string
description: A human-readable explanation specific to this occurrence of the problem.
Errors:
type: object
properties:
errors:
type: array
items:
$ref: '#/components/schemas/Error'
SupplierGroupBase:
title: Field
type: object
required:
- type
- id
properties:
type:
$ref: '#/components/schemas/SupplierGroupType'
id:
$ref: '#/components/schemas/SupplierGroupId'
SupplierGroupAttributes:
type: object
description: Supplier group attributes.
required:
- name
properties:
name:
type: string
maxLength: 255
description: Supplier group name.
external_id:
type: string
maxLength: 255
description: Supplier group external identifier.
SupplierGroupUpdate:
type: object
required:
- type
- id
properties:
type:
$ref: '#/components/schemas/SupplierGroupType'
id:
$ref: '#/components/schemas/SupplierGroupId'
attributes:
$ref: '#/components/schemas/SupplierGroupAttributes'
SupplierGroupType:
type: string
description: Object type, should always be `supplier_groups`.
example: supplier_groups
SupplierGroup:
allOf:
- $ref: '#/components/schemas/SupplierGroupBase'
- type: object
properties:
attributes:
$ref: '#/components/schemas/SupplierGroupAttributes'
SupplierGroupCreate:
type: object
required:
- type
properties:
type:
$ref: '#/components/schemas/SupplierGroupType'
attributes:
$ref: '#/components/schemas/SupplierGroupAttributes'
SupplierGroupId:
type: integer
description: Supplier group identifier string.
example: 1
examples:
update_request-9:
value:
data:
type: supplier_groups
id: '1'
attributes:
name: Supplier Group Updated
external_id: SUPGROUP-UPD
create_response-9:
value:
data:
id: '1'
type: supplier_groups
attributes:
name: 'Supplier Group #1'
external_id: SUPGROUP-1
links:
self: https://api.us.workdayspend.com/services/suppliers/v1/supplier_groups/1
update_response-9:
value:
data:
id: '1'
type: supplier_groups
attributes:
name: Supplier Group Updated
external_id: SUPGROUP-UPD
links:
self: https://api.us.workdayspend.com/services/suppliers/v1/supplier_groups/1
external_update_request-6:
value:
data:
type: supplier_groups
id: SUPGROUP
attributes:
name: Supplier Group Updated
external_update_response-6:
value:
data:
id: '1'
type: supplier_groups
attributes:
name: Supplier Group Updated
external_id: SUPGROUP
links:
self: https://api.us.workdayspend.com/services/suppliers/v1/supplier_groups/1
index_response-9:
value:
data:
- id: '1'
type: supplier_groups
attributes:
name: 'Supplier Group #1'
external_id: SUPGROUP-1
links:
self: https://api.us.workdayspend.com/services/suppliers/v1/supplier_groups/1
- id: '2'
type: supplier_groups
attributes:
name: 'Supplier Group #2'
external_id: SUPGROUP-2
links:
self: https://api.us.workdayspend.com/services/suppliers/v1/supplier_groups/2
links:
self: https://api.us.workdayspend.com/services/suppliers/v1/supplier_groups
create_request-8:
value:
data:
type: supplier_groups
attributes:
name: 'Supplier Group #1'
external_id: SUPGROUP-1
securitySchemes:
api_key:
type: apiKey
name: X-Api-Key
in: header
description: Company API key.
user_token:
type: apiKey
name: X-User-Token
in: header
description: User token.
user_email:
type: apiKey
name: X-User-Email
in: header
description: User email.
x-tagGroups:
- name: Getting Started
tags:
- support
- servers
- api_specification
- authentication
- rate_limiting
- name: Attachments
tags:
- attachments