Jump to

• Request
• Response
• Examples

Retrieve Security Policies in a Project

get

/ic/api/integration/v1/projects/{projectId}/mcp/policies/security

Retrieves security policies configured for a project.

Request

Path Parameters

• projectId(required): string
  Project identifier

  Example:

  MCP_PROJECT

Query Parameters

• expand: string
  Includes policy config in list responses when true. Valid values: true, false.
• integrationInstance(required): string
  This is the name of the service instance. You can get this value from the About page where it is specified in the Service instance field.

  Example:

  example-instance

• label: string
  Label parameter
• limit: integer(int32)
  Use with the offset parameter for paginating through the returned results.
• offset: integer(int32)
  Use with the limit parameter for paginating through the returned results.
• orderBy: string

  Lists policies ordered by name or last updated time.

  Valid values: name, time.

• q: string

  Filters security policies by name, status, and policyType.

  Example:

  {name:'Tools Policy', policyType:'TOOLS_FILTER'}

• return: string
  Accepted but ignored in this release; this parameter does not select a minimal or full response view.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/vnd.oracle.model+json;type=collection
• application/json; charset=utf-8

200 Response

Successful operation

Body ()

Root Schema : MCPPoliciesRs

Type: object

Paginated collection of MCP security or business policies in a project.

Show Source

• hasMore: boolean
  Whether more results are available.
• items: array items
  Items returned in this collection.
• limit: integer (int32)
  Maximum number of results in this response.
• totalResults: integer (int32)
  Total number of matching results.

{
    "type":"object",
    "properties":{
        "items":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/MCPPolicyListRs"
            },
            "description":"Items returned in this collection."
        },
        "totalResults":{
            "type":"integer",
            "format":"int32",
            "description":"Total number of matching results."
        },
        "hasMore":{
            "type":"boolean",
            "description":"Whether more results are available."
        },
        "limit":{
            "type":"integer",
            "format":"int32",
            "description":"Maximum number of results in this response."
        }
    },
    "description":"Paginated collection of MCP security or business policies in a project."
}

Nested Schema : items

Type: array

Items returned in this collection.

Show Source

• Array of: object MCPPolicyListRs
  MCP policy summary. Configuration is included when requested.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/MCPPolicyListRs"
    },
    "description":"Items returned in this collection."
}

Nested Schema : MCPPolicyListRs

Type: object

MCP policy summary. Configuration is included when requested.

Show Source

• code: string
  Resource code.
• config: object config
  Additional Properties Allowed: true

  Policy-type-specific configuration. Its required fields depend on the policy type.
• created: string (date-time)
  Time the resource was created.
• createdBy: string
  User who created the resource.
• description: string
  Description of the resource.
• iconclass: string
  Icon CSS class for displaying this policy or template.
• id: string
  Resource identifier.
• lastUpdated: string (date-time)
  Time the resource was last updated.
• lastUpdatedBy: string
  User who last updated the resource.
• links: array links
  Links to related resources.
• name: string
  Display name of the resource.
• policyType: string
  Policy type identifier.
• processingTime: number (float)
  Server-reported processing time.
• projectId: string
  Project identifier.
• projectName: string
  Project display name.
• scope: scope
  Resource scope to which the MCP policy applies.
• status: string
  Allowed Values: [ "INPROGRESS", "CONFIGURED" ]

  Current resource state.
• version: string
  Resource version. The release accepts only 01.00.0000 on writes and uses it when the version is omitted.

{
    "type":"object",
    "properties":{
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/MCP2610_Link"
            },
            "description":"Links to related resources."
        },
        "processingTime":{
            "type":"number",
            "format":"float",
            "description":"Server-reported processing time."
        },
        "id":{
            "type":"string",
            "description":"Resource identifier."
        },
        "projectId":{
            "type":"string",
            "description":"Project identifier."
        },
        "projectName":{
            "type":"string",
            "description":"Project display name."
        },
        "name":{
            "type":"string",
            "description":"Display name of the resource."
        },
        "code":{
            "type":"string",
            "description":"Resource code."
        },
        "version":{
            "type":"string",
            "description":"Resource version. The release accepts only 01.00.0000 on writes and uses it when the version is omitted."
        },
        "description":{
            "type":"string",
            "description":"Description of the resource."
        },
        "policyType":{
            "type":"string",
            "description":"Policy type identifier."
        },
        "status":{
            "type":"string",
            "enum":[
                "INPROGRESS",
                "CONFIGURED"
            ],
            "description":"Current resource state."
        },
        "created":{
            "type":"string",
            "format":"date-time",
            "description":"Time the resource was created."
        },
        "createdBy":{
            "type":"string",
            "description":"User who created the resource."
        },
        "lastUpdated":{
            "type":"string",
            "format":"date-time",
            "description":"Time the resource was last updated."
        },
        "lastUpdatedBy":{
            "type":"string",
            "description":"User who last updated the resource."
        },
        "scope":{
            "description":"Resource scope to which the MCP policy applies.",
            "allOf":[
                {
                    "$ref":"#/components/schemas/PolicyScopeRs"
                }
            ]
        },
        "config":{
            "type":"object",
            "additionalProperties":true,
            "description":"Policy-type-specific configuration. Its required fields depend on the policy type."
        },
        "iconclass":{
            "type":"string",
            "description":"Icon CSS class for displaying this policy or template."
        }
    },
    "description":"MCP policy summary. Configuration is included when requested."
}

Nested Schema : config

Type: object

Additional Properties Allowed: true

Policy-type-specific configuration. Its required fields depend on the policy type.

Nested Schema : links

Type: array

Links to related resources.

Show Source

• Array of: object MCP2610_Link
  A link to a related REST resource.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/MCP2610_Link"
    },
    "description":"Links to related resources."
}

Nested Schema : scope

Resource scope to which the MCP policy applies.

Match All

Resource scope to which the MCP policy applies.

Show Source

• object PolicyScopeRs
  Resource scope to which the MCP policy applies.

{
    "description":"Resource scope to which the MCP policy applies.",
    "allOf":[
        {
            "$ref":"#/components/schemas/PolicyScopeRs"
        }
    ]
}

Nested Schema : MCP2610_Link

Type: object

A link to a related REST resource.

Show Source

• href: string
  URL of the linked resource.
• mediaType: string
  Media type of the linked resource.
• rel: string
  Relationship of the linked resource.

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "description":"Relationship of the linked resource."
        },
        "href":{
            "type":"string",
            "description":"URL of the linked resource."
        },
        "mediaType":{
            "type":"string",
            "description":"Media type of the linked resource."
        }
    },
    "description":"A link to a related REST resource."
}

Nested Schema : PolicyScopeRs

Type: object

Resource scope to which the MCP policy applies.

Show Source

• code: string
  Resource code.
• level: string
  Scope level.
• version: string
  Version of the referenced resource, defaulting to 01.00.0000 where a version is used.

{
    "type":"object",
    "properties":{
        "level":{
            "type":"string",
            "description":"Scope level."
        },
        "code":{
            "type":"string",
            "description":"Resource code."
        },
        "version":{
            "type":"string",
            "description":"Version of the referenced resource, defaulting to 01.00.0000 where a version is used."
        }
    },
    "description":"Resource scope to which the MCP policy applies."
}

400 Response

Malformed parameters

401 Response

Unauthorized or insufficient design-time permissions

404 Response

Project or resource not found, or the MCP feature is not available

500 Response

Server error

Back to Top

Examples

The following example shows how to retrieve security policies configured for a project by submitting a GET request on the REST resource using cURL. For more information about cURL, see Use cURL. For more information about endpoint URL structure, see Send Requests.

Example: Retrieve Security Policies in a Project

curl --request GET --include \
  --url "${BASE_URL}/ic/api/integration/v1/projects/${PROJECT_ID}/mcp/policies/security?integrationInstance=${INTEGRATION_INSTANCE}" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "Accept: application/json"

Back to Top