OutSystems IP filters API

Create, update, and delete IP filter groups and rules.

Documentation GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

DELETE /environments/{environmentKey}/ip-filter-groups/{ipFilterGroupKey} Delete an IP filter group · Deletes a specific IP filter group for an environment (stage) #

Ask an LLM

“Can I remove an IP filter group from a stage?”

“What permission do I need to delete IP restrictions in ODC?”

Tell an agent destructive · confirm first

Delete IP filter group {ipFilterGroupKey} from stage {environmentKey}.

Remove IP restrictions group {ipFilterGroupKey} in {environmentKey}.

GET /environments/{environmentKey}/ip-filter-groups/{ipFilterGroupKey} Get one IP filter group · Returns information about a specific IP filter group for an environment (stage) #

Ask an LLM

“What IP rules are in a specific IP filter group?”

“Which apps does a given IP filter group protect?”

Tell an agent

Get IP filter group {ipFilterGroupKey} in stage {environmentKey}.

Show the rules of IP filter group {ipFilterGroupKey} for environment {environmentKey}.

PATCH /environments/{environmentKey}/ip-filter-groups/{ipFilterGroupKey} Update an IP filter group · Updates an IP filter group for an environment (stage) #

Ask an LLM

“How do I add new IP ranges to an existing IP filter group?”

“Can I change whether an IP filter group allows or blocks access?”

Tell an agent

Update the IP rules of group {ipFilterGroupKey} in stage {environmentKey} to {ipRules}.

Change IP filter group {ipFilterGroupKey} in {environmentKey} to access type {accessType}.

GET /environments/{environmentKey}/ip-filter-groups List IP filter groups in a stage · Returns the list of IP filter groups for an environment (stage) #

Ask an LLM

“What IP filter groups restrict access in my stage?”

“Can I see only the IP filters applied to particular apps?”

Tell an agent

List IP filter groups in stage {environmentKey}.

Show IP filter groups in {environmentKey} that apply to apps {appKeys}.

POST /environments/{environmentKey}/ip-filter-groups Create an IP filter group · Creates a new IP filter group in an environment (stage) #

Ask an LLM

“How do I restrict app access to certain IP addresses in a stage?”

“Can I create an IP filter group that applies only to specific apps?”

Tell an agent

Create IP filter group {name} in stage {environmentKey} with rules {ipRules}.

Create an IP filter in {environmentKey} named {name} for apps {appKeys}.

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/outsystems/refs/heads/main/openapi/outsystems-ip-filters-api-openapi.yml

Schemas & Data

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/outsystems/refs/heads/main/json-schema/outsystems-ip-filter-group-schema.json

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/outsystems/refs/heads/main/json-schema/outsystems-base-ip-filter-group-schema.json

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/outsystems/refs/heads/main/json-schema/outsystems-patch-ip-filter-group-schema.json

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/outsystems/refs/heads/main/json-schema/outsystems-ip-filter-groups-schema.json

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/outsystems/refs/heads/main/json-schema/outsystems-ip-filter-group-key-schema.json

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/outsystems:outsystems-ip-filters-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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Environment Configurations IP filters API
  description: REST endpoints for managing environment (stage) configurations in ODC. Covers custom domains, IP filters, and Private Gateways, enabling you to automate the same configurations available in ODC Portal.
  version: v1
servers:
- url: https://ODC_PORTAL_DOMAIN/api/environment-configurations/v1
  description: Replace ODC_PORTAL_DOMAIN with the domain of your organization.
- url: https://{odc-portal-domain}/api/environment-configurations/v1
  description: Replace {odc-portal-domain} with the domain of your organization.
  variables:
    '{odc-portal-domain}':
      default: '{odc-portal-domain}'
      description: The domain of your organization
security:
- bearerAuth: []
tags:
- name: IP filters
  description: Create, update, and delete IP filter groups and rules.
paths:
  /environments/{environmentKey}/ip-filter-groups/{ipFilterGroupKey}:
    delete:
      tags:
      - IP filters
      summary: Deletes a specific IP filter group for an environment (stage)
      description: 'Deletes a specific IP filter group for an environment (stage).


        API Client needs the **Configuration management > Manage IP filters** permission for the target environment (stage).'
      operationId: IpFilterGroups_Delete
      parameters:
      - name: environmentKey
        in: path
        description: The environment's key.
        required: true
        schema:
          type: string
      - name: ipFilterGroupKey
        in: path
        description: The IP filter group's key.
        required: true
        schema:
          type: string
      responses:
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '204':
          description: No Content
      x-os-permissions: API Client needs the **Configuration management > Manage IP filters** permission for the target environment (stage).
    get:
      tags:
      - IP filters
      summary: Returns information about a specific IP filter group for an environment (stage)
      description: 'Returns information about a specific IP filter group for an environment (stage).


        API Client needs the **Configuration management > View configurations** permission for the target environment (stage).'
      operationId: IpFilterGroups_Get
      parameters:
      - name: environmentKey
        in: path
        description: The environment's key.
        required: true
        schema:
          type: string
      - name: ipFilterGroupKey
        in: path
        description: The IP filter group's key.
        required: true
        schema:
          type: string
      responses:
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IpFilterGroup'
      x-os-permissions: API Client needs the **Configuration management > View configurations** permission for the target environment (stage).
    patch:
      tags:
      - IP filters
      summary: Updates an IP filter group for an environment (stage)
      description: 'Updates an IP filter group for an environment (stage).


        API Client needs the **Configuration management > Manage IP filters** permission for the target environment (stage).'
      operationId: IpFilterGroups_Patch
      parameters:
      - name: environmentKey
        in: path
        description: The environment's key.
        required: true
        schema:
          type: string
      - name: ipFilterGroupKey
        in: path
        description: The IP filter group's key.
        required: true
        schema:
          type: string
      requestBody:
        description: The details of the IP filter group being updated.
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/PatchIpFilterGroup'
          application/*+json:
            schema:
              allOf:
              - $ref: '#/components/schemas/PatchIpFilterGroup'
      responses:
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '204':
          description: No Content
      x-os-permissions: API Client needs the **Configuration management > Manage IP filters** permission for the target environment (stage).
  /environments/{environmentKey}/ip-filter-groups:
    get:
      tags:
      - IP filters
      summary: Returns the list of IP filter groups for an environment (stage)
      description: 'Returns the list of IP filter groups for an environment (stage).


        API Client needs the **Configuration management > View configurations** permission for the target environment (stage).'
      operationId: IpFilterGroups_List
      parameters:
      - name: environmentKey
        in: path
        description: The environment's key.
        required: true
        schema:
          type: string
      - name: appKeys
        in: query
        description: Comma-separated list of app keys to filter the results.
        schema:
          type: array
          items:
            type: string
      responses:
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IpFilterGroups'
      x-os-permissions: API Client needs the **Configuration management > View configurations** permission for the target environment (stage).
    post:
      tags:
      - IP filters
      summary: Creates a new IP filter group in an environment (stage)
      description: 'Creates a new IP filter group in an environment (stage).


        API Client needs the **Configuration management > Manage IP filters** permission for the target environment (stage).'
      operationId: IpFilterGroups_Post
      parameters:
      - name: environmentKey
        in: path
        description: The environment's key.
        required: true
        schema:
          type: string
      requestBody:
        description: The details of the new IP filter group.
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/BaseIpFilterGroup'
          application/*+json:
            schema:
              allOf:
              - $ref: '#/components/schemas/BaseIpFilterGroup'
      responses:
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IpFilterGroupKey'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      x-os-permissions: API Client needs the **Configuration management > Manage IP filters** permission for the target environment (stage).
components:
  schemas:
    IpFilterGroupAccessType:
      enum:
      - DENYLIST
      - ALLOWLIST
      type: string
    IpFilterGroup:
      type: object
      properties:
        name:
          type:
          - string
          - 'null'
          description: The name of the IP filter group.
        description:
          type:
          - string
          - 'null'
          description: The description of the IP filter group.
        accessType:
          allOf:
          - $ref: '#/components/schemas/IpFilterGroupAccessType'
          description: The default access type of the IP filter group, after all rules are applied.
        ipRules:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/IpFilterGroupRule'
          description: The list of IP filter rules associated with this group.
        appKeys:
          type:
          - array
          - 'null'
          items:
            type: string
          description: The list of all app keys that are explicitly assigned to this group.
        key:
          type:
          - string
          - 'null'
          description: The unique identifier of the IP filter group.
      additionalProperties: false
    BaseIpFilterGroup:
      type: object
      properties:
        name:
          type:
          - string
          - 'null'
          description: The name of the IP filter group.
        description:
          type:
          - string
          - 'null'
          description: The description of the IP filter group.
        accessType:
          allOf:
          - $ref: '#/components/schemas/IpFilterGroupAccessType'
          description: The default access type of the IP filter group, after all rules are applied.
        ipRules:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/IpFilterGroupRule'
          description: The list of IP filter rules associated with this group.
        appKeys:
          type:
          - array
          - 'null'
          items:
            type: string
          description: The list of all app keys that are explicitly assigned to this group.
      additionalProperties: false
    IpFilterGroups:
      type: object
      properties:
        results:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/IpFilterGroup'
          description: The list of IP filter groups.
      additionalProperties: false
    PatchIpFilterGroup:
      type: object
      properties:
        name:
          type:
          - string
          - 'null'
          description: The name of the group
        description:
          type:
          - string
          - 'null'
          description: The description of the group
        accessType:
          allOf:
          - $ref: '#/components/schemas/IpFilterGroupAccessType'
          description: Default access type in group, after all rules are applied
        ipRules:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/IpFilterGroupRule'
          description: All the rules associated with this group
        appKeys:
          type:
          - array
          - 'null'
          items:
            type: string
          description: List of all applications that are explicitly assigned to this group.
      additionalProperties: false
    ProblemDetails:
      type: object
      properties:
        type:
          type:
          - string
          - 'null'
          description: A URI reference that identifies the problem type.
        title:
          type:
          - string
          - 'null'
          description: A short, human-readable summary of the problem.
        status:
          type:
          - integer
          - 'null'
          description: The HTTP status code applicable to the problem.
          format: int32
        detail:
          type:
          - string
          - 'null'
          description: A human-readable explanation of the error.
        instance:
          type:
          - string
          - 'null'
          description: A URI that identifies the specific occurrence of the problem.
        traceId:
          type: string
          description: This field helps OutSystems support track and investigate specific error occurrences. Providing this identifier when reporting an issue allows for more precise and faster troubleshooting.
        errorCode:
          type: string
          description: This error code serves the purpose to communicate with OutSystems Support and help diagnose errors.
      description: A standardized error response as per RFC 7807 (Problem Details for HTTP APIs).
    IpFilterGroupRule:
      type: object
      properties:
        name:
          type:
          - string
          - 'null'
          description: The name of the IP rule.
        ranges:
          type:
          - array
          - 'null'
          items:
            type: string
          description: 'The list of the IP ranges (e.g: 0.0.0.0-0.0.0.3).'
        isActive:
          type: boolean
          description: Indicates if the IP rule is currently active.
      additionalProperties: false
    IpFilterGroupKey:
      type: object
      properties:
        key:
          type:
          - string
          - 'null'
          description: The key identifier of the Ip filter group
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      description: Enter your bearer token in the format 'Bearer {token}'
      scheme: bearer
      bearerFormat: JWT