Skip to content

Object Requests REST API

Published: 2026-08-31

Last Updated: 2026-08-31

Return object requests in MDCMS. Optional query parameters further limit the list by request number, application, level, RFP, reason, status, create status, object type, attribute, object name, source name, user, Git repository, branch, or linked project, task, and subtask.

GET /object-requests

JSON payloads

All MDCMS REST API response bodies use JSON.

Authorization

Header Type Required Description
Authorization string Yes Bearer token for the MDSEC user. See Authenticate requests to the MDCMS REST API server.

A missing or invalid token returns HTTP 401 Unauthorized.

Query parameters

All parameters are optional. Omit all parameters to return every object request.

Parameter Type Required Description
objectId integer No Limit the list to this object request number.
appl string No Application code that contains the object requests to list.
lvl integer No Application level that contains the object requests to list.
rfp integer No Limit the list to this RFP number.
reason string No Limit the list to object requests with this reason. Allowed values: modify, delete, recompile, update.
status string No Limit the list to object requests with this status code.
createStatus string No Limit the list to object requests with this create status. Allowed values: created, error.
objectType string No Limit the list to this object type.
attr string No Limit the list to this MDCMS attribute.
objectName string No Substring to match against the object name. Any request whose object name contains this value is returned. Matching is case-insensitive.
sourceName string No Substring to match against the source name. Any request whose source name contains this value is returned. Matching is case-insensitive.
user string No Limit the list to object requests assigned to this user.
repoId string No Limit the list to object requests for this Git repository ID.
branch string No Limit the list to object requests for this Git branch.
project string No Limit the list to object requests linked to this project.
task integer No Limit the list to object requests linked to this task.
subtask integer No Limit the list to object requests linked to this subtask.

project, task, and subtask can be combined. When any of them is supplied, only object requests with a matching project/task/subtask assignment are returned. Each matching request still includes every project/task/subtask assignment in the tasks array.

Example

Replace {endpoint} with the URL endpoint defined for the MDCMS HTTP server.

curl -H "Authorization: Bearer {token}" \
  "https://{endpoint}/object-requests?appl=TEST&lvl=10&reason=modify&objectName=MDWS&project=DEMO044"

GET /object-requests?appl=TEST&lvl=10&reason=modify&objectName=MDWS&project=DEMO044 HTTP/1.1
Host: {endpoint}
Authorization: Bearer {token}

Response body

Schema

Property Type Description
objectRequests array List of object request objects.

Object request object

Property Type Description
objectId integer Object request number.
appl string Application code.
lvl integer Application level.
rfp integer RFP number. 0 if the request is not assigned to an RFP.
reason string Reason for the request. One of modify, delete, recompile, or update.
status string Object request status code.
createStatus string Create status. One of created or error. Empty when neither applies.
objectType string Object type.
attr string MDCMS attribute.
objectName string Object name.
sourceName string Source member or source file name.
user string User assigned to the object request.
repoId string Git repository ID, when the request is linked to Git.
branch string Git branch, when the request is linked to Git.
fromObjectLibrary string Library or IFS path that contains the object.
fromSourceLibrary string Library or IFS path that contains the source.
fromSourceFile string Source file that contains the source member.
tasks array List of task assignments for the request.

Task object

Property Type Description
project string Project ID.
task integer Task number. 0 when the request is assigned directly to the project.
subtask integer Subtask number. 0 when the request is assigned directly to the project or task.

Example

{
  "objectRequests": [
    {
      "objectId": 45281,
      "appl": "TEST",
      "lvl": 10,
      "rfp": 1340,
      "reason": "modify",
      "status": "00",
      "createStatus": "created",
      "objectType": "*PGM",
      "attr": "SQLRPGLE",
      "objectName": "MDWSREQS",
      "sourceName": "MDWSREQS",
      "user": "MMORGAN",
      "repoId": "MDCMS",
      "branch": "V8.6-83",
      "fromObjectLibrary": "MMORGAN13",
      "fromSourceLibrary": "MMORGAN13",
      "fromSourceFile": "QRPGLESRC",
      "tasks": [
        {
          "project": "DEMO044",
          "task": 2,
          "subtask": 3
        }
      ]
    },
    {
      "objectId": 45290,
      "appl": "TEST",
      "lvl": 10,
      "rfp": 0,
      "reason": "recompile",
      "status": "00",
      "createStatus": "",
      "objectType": "*FILE",
      "attr": "PF",
      "objectName": "MDDCMSD",
      "sourceName": "MDDCMSD",
      "user": "MMORGAN",
      "repoId": "",
      "branch": "",
      "fromObjectLibrary": "MMORGAN13",
      "fromSourceLibrary": "MMORGAN13",
      "fromSourceFile": "QDDSSRC",
      "tasks": [
        {
          "project": "DEMO044",
          "task": 2,
          "subtask": 0
        },
        {
          "project": "DEMOCH",
          "task": 1,
          "subtask": 0
        }
      ]
    }
  ]
}
Resource Description
Object Request REST API Create an object request and optionally assign it to an RFP
Open RFPs REST API List active RFPs
Attributes REST API List attributes for an application and level
Git Repositories REST API List Git repositories defined in MDCMS
Open Projects REST API List active projects
Open Tasks REST API List active tasks for a project
Open Subtasks REST API List active subtasks for a project and task