Scout RFP (Workday Strategic Sourcing) fields API

Use the fields API to create, update, and query the custom fields in Workday Strategic Sourcing. ## Field Object

Operations 5

GET /fields List Fields #
POST /fields Create a Field #
GET /fields/{id} Get a Field #
PATCH /fields/{id} Update a Field #
DELETE /fields/{id} Delete a Field #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/scoutrfp-fields-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

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 Specification

scoutrfp-fields-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Workday Strategic Sourcing attachments Fields 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: fields
  x-displayName: Fields
  description: 'Use the fields API to create, update, and query the custom fields in Workday Strategic Sourcing.


    ## Field Object


    <SchemaDefinition schemaRef="#/components/schemas/Field" showReadOnly={true} showWriteOnly={true} />

    '
paths:
  /fields:
    get:
      tags:
      - fields
      description: Returns a list of custom fields for the specified criteria.
      operationId: List Fields
      summary: List Fields
      parameters:
      - name: filter
        in: query
        description: 'Filter custom fields by multiple criteria. Only one filter per attribute is supported.

          For best performance, we recommend 5 or less filters.

          '
        schema:
          $ref: '#/components/schemas/FieldInputFilter'
      responses:
        '200':
          description: OK
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Field'
              examples:
                success:
                  $ref: '#/components/examples/index_response'
        '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/fields/v1/fields\"\n"
    post:
      tags:
      - fields
      description: 'Create a field with given parameters.


        For fields with `target_object` set to `RFP`, `group` relationship should be omitted. It is

        required to specify the relationship for all other target objects.

        '
      operationId: Create a Field
      summary: Create a Field
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              type: object
              properties:
                data:
                  $ref: '#/components/schemas/FieldCreate'
            examples:
              success:
                $ref: '#/components/examples/create_request'
      responses:
        '201':
          description: OK
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Field'
              examples:
                success:
                  $ref: '#/components/examples/create_response'
        '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\":\"fields\",\"attributes\":{\"name\":\"custom_field\"}}' \\\n     \"https://api.us.workdayspend.com/services/fields/v1/fields\"\n"
  /fields/{id}:
    get:
      tags:
      - fields
      description: 'Retrieves the details of an existing field. You need to supply the unique field

        identifier that was returned upon field creation.

        '
      operationId: Get a Field
      summary: Get a Field
      parameters:
      - name: id
        in: path
        description: Unique Field identifier.
        required: true
        schema:
          type: integer
        example: 1
      responses:
        '200':
          description: OK
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Field'
              examples:
                success:
                  $ref: '#/components/examples/show_response'
        '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     \"https://api.us.workdayspend.com/services/fields/v1/fields/1\"\n"
    patch:
      tags:
      - fields
      description: 'Updates the details of an existing field. You need to supply the unique

        identifier that was returned upon field creation.


        For fields with `target_object` set to `RFP`, `group` relationship should be omitted.


        Please note, that request body must include an `id` attribute with the value of your field

        unique identifier (the same one you passed in the URL).

        '
      operationId: Update a Field
      summary: Update a Field
      parameters:
      - name: id
        in: path
        description: Unique Field identifier.
        required: true
        schema:
          type: integer
        example: 1
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              type: object
              properties:
                data:
                  $ref: '#/components/schemas/FieldUpdate'
            examples:
              success:
                $ref: '#/components/examples/update_request'
      responses:
        '200':
          description: OK
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Field'
              examples:
                success:
                  $ref: '#/components/examples/update_response'
        '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 'fields'
                  description: 'Returns error due to invalid `type` parameter.

                    '
                  value:
                    errors:
                    - detail: Missing or invalid 'type' specified, expected 'fields'
      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\":\"fields\",\"id\":\"2\",\"attributes\":{\"name\":\"Updated Field Name\"}}}' \\\n     \"https://api.us.workdayspend.com/services/fields/v1/fields/2\"\n"
    delete:
      tags:
      - fields
      description: 'Deletes a field. You need to supply the unique field

        identifier that was returned upon field creation.

        '
      operationId: Delete a Field
      summary: Delete a Field
      parameters:
      - name: id
        in: path
        description: Unique Field 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/fields/v1/fields/1\"\n"
components:
  schemas:
    Error:
      type: object
      properties:
        detail:
          type: string
          description: A human-readable explanation specific to this occurrence of the problem.
    FieldBase:
      title: Field
      type: object
      required:
      - type
      - id
      properties:
        type:
          $ref: '#/components/schemas/FieldType'
        id:
          $ref: '#/components/schemas/FieldId'
    Errors:
      type: object
      properties:
        errors:
          type: array
          items:
            $ref: '#/components/schemas/Error'
    FieldRelationship:
      type: object
      description: Field relationship.
      properties:
        group:
          type: object
          description: 'Reference to the field group where the field belongs to. It is always `null` for fields

            with `target_object` set to RFP, and required for all other fields.

            '
          properties:
            data:
              $ref: '#/components/schemas/FieldGroupBase'
    FieldAttributes:
      type: object
      description: Field attributes.
      required:
      - name
      properties:
        name:
          type: string
          maxLength: 255
          description: Field name.
        target_object:
          type: string
          enum:
          - PROJECT
          - RFP
          - SUPPLIER_COMPANY
          description: Field object type string.
        data_type:
          allOf:
          - $ref: '#/components/schemas/OpenApiEnum'
          - readOnly: true
        type_description:
          $ref: '#/components/schemas/CustomFieldEnum'
        position:
          type: integer
          description: Field order position on the UI.
          readOnly: true
        required:
          type: boolean
          description: 'Identifies whether the field is required in order to create the object successfully.

            '
    FieldGroupId:
      type: integer
      description: Field group identifier string.
      example: 1
    OpenApiEnum:
      type: string
      enum:
      - string
      - number
      - integer
      - boolean
      - array
      - object
      description: OpenAPI data type.
      example: string
    ResourceLinks:
      type: object
      description: List of related links.
      allOf:
      - $ref: '#/components/schemas/SelfLink'
    FieldInputFilter:
      type: object
      properties:
        group_id_equals:
          type: string
          description: ID of the group for which fields should be selected.
          example: 1
        target_object_equals:
          type: string
          description: Find custom fields by target class name.
          example: RFP
    CustomFieldEnum:
      type: string
      enum:
      - Checkbox
      - File
      - Short Text
      - Paragraph
      - Date
      - Integer
      - Currency
      - Decimal
      - Single Select
      - Multiple Select
      - URL
      - Lookup
      - Related
      description: Internal name and meaning of each field.
      example: Short Text
    Field:
      allOf:
      - $ref: '#/components/schemas/FieldBase'
      - type: object
        properties:
          attributes:
            $ref: '#/components/schemas/FieldAttributes'
          relationships:
            $ref: '#/components/schemas/FieldRelationship'
          links:
            $ref: '#/components/schemas/ResourceLinks'
    FieldGroupType:
      type: string
      description: Object type, should always be `field_groups`.
      example: field_groups
    FieldId:
      type: integer
      description: Field identifier string.
      example: 1
    FieldGroupBase:
      title: Field
      type: object
      required:
      - type
      - id
      properties:
        type:
          $ref: '#/components/schemas/FieldGroupType'
        id:
          $ref: '#/components/schemas/FieldGroupId'
    SelfLink:
      type: object
      properties:
        self:
          type: string
          format: url
          description: Normalized link to the resource.
    FieldType:
      type: string
      description: Object type, should always be `fields`.
      example: fields
    FieldUpdate:
      type: object
      required:
      - type
      - id
      properties:
        type:
          $ref: '#/components/schemas/FieldType'
        id:
          $ref: '#/components/schemas/FieldId'
        attributes:
          allOf:
          - $ref: '#/components/schemas/FieldAttributes'
          - type: object
            properties:
              target_object:
                readOnly: true
        relationships:
          $ref: '#/components/schemas/FieldRelationship'
    FieldCreate:
      type: object
      required:
      - type
      properties:
        type:
          $ref: '#/components/schemas/FieldType'
        attributes:
          $ref: '#/components/schemas/FieldAttributes'
        relationships:
          $ref: '#/components/schemas/FieldRelationship'
  examples:
    create_response:
      value:
        data:
          id: '1'
          type: fields
          attributes:
            target_object: PROJECT
            name: Custom Field
            data_type: string
            type_description: Short Text
            position: null
            required: false
          relationships:
            group:
              data:
                id: '1'
                type: field_groups
          links:
            self: https://api.us.workdayspend.com/services/fields/v1/fields/1
    create_request:
      value:
        data:
          type: fields
          attributes:
            target_object: PROJECT
            name: Custom Field
            type_description: Short Text
            required: false
          relationships:
            group:
              data:
                type: field_groups
                id: '1'
    index_response:
      value:
        data:
        - id: '1'
          type: fields
          attributes:
            target_object: PROJECT
            name: Field One
            data_type: string
            type_description: Short Text
            position: null
            required: false
          relationships:
            group:
              data:
                id: '1'
                type: field_groups
          links:
            self: https://api.us.workdayspend.com/services/fields/v1/fields/1
        - id: '2'
          type: fields
          attributes:
            target_object: PROJECT
            name: Field Two
            data_type: string
            type_description: Single Select
            position: null
            required: false
          relationships:
            group:
              data:
                id: '1'
                type: field_groups
          links:
            self: https://api.us.workdayspend.com/services/fields/v1/fields/2
        links:
          self: https://api.us.workdayspend.com/services/fields/v1/fields
    show_response:
      value:
        data:
          id: '1'
          type: fields
          attributes:
            target_object: PROJECT
            name: Field One
            data_type: string
            type_description: Short Text
            position: null
            required: false
          relationships:
            group:
              data:
                id: '1'
                type: field_groups
          links:
            self: https://api.us.workdayspend.com/services/fields/v1/fields/1
    update_request:
      value:
        data:
          id: '1'
          type: fields
          attributes:
            name: Updated Custom Field
            type_description: Short Text
            required: true
          relationships:
            group:
              data:
                id: '2'
                type: field_groups
    update_response:
      value:
        data:
          id: '1'
          type: fields
          attributes:
            target_object: PROJECT
            name: Updated Custom Field
            data_type: string
            type_description: Short Text
            position: null
            required: true
          relationships:
            group:
              data:
                id: '2'
                type: field_groups
          links:
            self: https://api.us.workdayspend.com/services/fields/v1/fields/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