The type of file: - `ROOT` — The file containing the full OpenAPI structure. This serves as the entry point for the API spec and references other (`DEFAULT`) spec files. Multi-file specs can only have
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/postman/main/json-schema/postman-create-update-spec-file-response-schema.json",
"title": "createUpdateSpecFileResponse",
"description": "Information about the API specification file.",
"x-generated": "2026-10-04",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/postman-specs-api-openapi.yml#/components/schemas/createUpdateSpecFileResponse",
"type": "object",
"properties": {
"createdAt": {
"type": "string",
"format": "date-time",
"description": "The date and time at which the file was created."
},
"createdBy": {
"type": "integer",
"description": "The user ID of the user that created the file."
},
"id": {
"type": "string",
"description": "The file's ID."
},
"path": {
"type": "string",
"description": "The file's path."
},
"updatedAt": {
"type": "string",
"format": "date-time",
"description": "The date and time at which the file was updated."
},
"updatedBy": {
"type": "integer",
"description": "The ID of the user who updated the file."
},
"type": {
"$ref": "#/$defs/CreateUpdateSpecFileResponseType",
"default": "DEFAULT",
"description": "The type of file:\n- `ROOT` — The file containing the full OpenAPI structure. This serves as the entry point for the API spec and references other (`DEFAULT`) spec files. Multi-file specs can only have one root file.\n- `DEFAULT` — A file referenced by the `ROOT` file.\n"
}
},
"$defs": {
"CreateUpdateSpecFileResponseType": {
"type": "string",
"enum": [
"DEFAULT",
"ROOT"
],
"default": "DEFAULT",
"description": "The type of file:\n- `ROOT` — The file containing the full OpenAPI structure. This serves as the entry point for the API spec and references other (`DEFAULT`) spec files. Multi-file specs can only have one root file.\n- `DEFAULT` — A file referenced by the `ROOT` file.\n",
"title": "CreateUpdateSpecFileResponseType"
}
}
}
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.