Create saved services

POST/api/v1/workspaces/{workspaceId}/services

Operation ID: services.create · Access: PAT with write scope and authorized workspace where applicable · Effect: write.

Read the saved services workflow before this operation.

Parameters

Name	In	Required	Type / allowed values
workspaceId	path	Yes	string
idempotency-key	header	No	string

Request body

Content type: application/json · Required: yes.

Schema: ServiceInput. Browse schema fields.

Example: request

Synthetic contract example. Replace identifiers and clinical data with authorized values. This example does not prove ministry acceptance.

Download JSON

{
  "category": 1,
  "name": "Consulta de ejemplo",
  "payload": {
    "codPrestador": "110010000101",
    "fechaInicioAtencion": "2026-09-01 10:00",
    "numAutorizacion": null,
    "codConsulta": "890201",
    "modalidadGrupoServicioTecSal": "01",
    "grupoServicios": "01",
    "codServicio": 325,
    "finalidadTecnologiaSalud": "44",
    "causaMotivoAtencion": "38",
    "codDiagnosticoPrincipal": "Z000",
    "codDiagnosticoRelacionado1": null,
    "codDiagnosticoRelacionado2": null,
    "codDiagnosticoRelacionado3": null,
    "tipoDiagnosticoPrincipal": "01",
    "tipoDocumentoIdentificacion": "CC",
    "numDocumentoIdentificacion": "1000000001",
    "vrServicio": 100000,
    "conceptoRecaudo": "05",
    "valorPagoModerador": 0,
    "numFEVPagoModerador": null,
    "consecutivo": 1
  }
}

Responses

HTTP	Content	Schema
201	application/json	Service
400	application/json	ApiError
401	application/json	ApiError
403	application/json	ApiError
404	application/json	ApiError
409	application/json	ApiError
413	application/json	ApiError
415	application/json	ApiError
428	application/json	ApiError
500	application/json	ApiError

Use error.code, error.issues, and requestId for JSON errors. Error and recovery guide.

cURL

Set the connection variables from the quickstart. Set each path variable to an authorized identifier or an allowed parameter value from the table above.

Save your authorized JSON input as request.json. Use the request schema and examples above; replace synthetic data before use.

curl --fail-with-body --request POST \
  "$RIPSCLOUD_BASE_URL/api/v1/workspaces/$WORKSPACE_ID/services" \
  --header "Authorization: Bearer $RIPSCLOUD_TOKEN" \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data-binary @request.json