Skip to content

The Report Generation section of the InvenTree API schema is documented below.

InvenTree API 341

API for InvenTree - the intuitive open source inventory management system


License: MIT

Servers

Description URL
http://localhost:8000 http://localhost:8000

report


GET /api/report/asset/

Description

API endpoint for listing ReportAsset objects.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"
limit query integer No Number of results to return per page.
offset query integer No The initial index from which to return the results.

Response 200 OK

{
    "count": 123,
    "next": "http://api.example.org/accounts/?offset=400&limit=100",
    "previous": "http://api.example.org/accounts/?offset=200&limit=100",
    "results": [
        {
            "asset": "string",
            "description": "string",
            "pk": 0
        }
    ]
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "properties": {
        "count": {
            "example": 123,
            "type": "integer"
        },
        "next": {
            "example": "http://api.example.org/accounts/?offset=400&limit=100",
            "format": "uri",
            "nullable": true,
            "type": "string"
        },
        "previous": {
            "example": "http://api.example.org/accounts/?offset=200&limit=100",
            "format": "uri",
            "nullable": true,
            "type": "string"
        },
        "results": {
            "items": {
                "$ref": "#/components/schemas/ReportAsset"
            },
            "type": "array"
        }
    },
    "required": [
        "count",
        "results"
    ],
    "type": "object"
}

POST /api/report/asset/

Description

API endpoint for listing ReportAsset objects.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"

Request body

{
    "asset": "string",
    "description": "string",
    "pk": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for the ReportAsset model.",
    "properties": {
        "asset": {
            "format": "uri",
            "type": "string"
        },
        "description": {
            "description": "Asset file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        }
    },
    "required": [
        "asset",
        "description",
        "pk"
    ],
    "type": "object"
}

{
    "asset": "string",
    "description": "string",
    "pk": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for the ReportAsset model.",
    "properties": {
        "asset": {
            "format": "uri",
            "type": "string"
        },
        "description": {
            "description": "Asset file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        }
    },
    "required": [
        "asset",
        "description",
        "pk"
    ],
    "type": "object"
}

{
    "asset": "string",
    "description": "string",
    "pk": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for the ReportAsset model.",
    "properties": {
        "asset": {
            "format": "uri",
            "type": "string"
        },
        "description": {
            "description": "Asset file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        }
    },
    "required": [
        "asset",
        "description",
        "pk"
    ],
    "type": "object"
}

Response 201 Created

{
    "asset": "string",
    "description": "string",
    "pk": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "description": "Serializer class for the ReportAsset model.",
    "properties": {
        "asset": {
            "format": "uri",
            "type": "string"
        },
        "description": {
            "description": "Asset file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        }
    },
    "required": [
        "asset",
        "description",
        "pk"
    ],
    "type": "object"
}

DELETE /api/report/asset/{id}/

Description

API endpoint for a single ReportAsset object.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"
id path integer No

Response 204 No Content


GET /api/report/asset/{id}/

Description

API endpoint for a single ReportAsset object.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"
id path integer No

Response 200 OK

{
    "asset": "string",
    "description": "string",
    "pk": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "description": "Serializer class for the ReportAsset model.",
    "properties": {
        "asset": {
            "format": "uri",
            "type": "string"
        },
        "description": {
            "description": "Asset file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        }
    },
    "required": [
        "asset",
        "description",
        "pk"
    ],
    "type": "object"
}

PATCH /api/report/asset/{id}/

Description

API endpoint for a single ReportAsset object.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"
id path integer No

Request body

{
    "asset": "string",
    "description": "string",
    "pk": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for the ReportAsset model.",
    "properties": {
        "asset": {
            "format": "uri",
            "type": "string"
        },
        "description": {
            "description": "Asset file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        }
    },
    "type": "object"
}

{
    "asset": "string",
    "description": "string",
    "pk": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for the ReportAsset model.",
    "properties": {
        "asset": {
            "format": "uri",
            "type": "string"
        },
        "description": {
            "description": "Asset file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        }
    },
    "type": "object"
}

{
    "asset": "string",
    "description": "string",
    "pk": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for the ReportAsset model.",
    "properties": {
        "asset": {
            "format": "uri",
            "type": "string"
        },
        "description": {
            "description": "Asset file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        }
    },
    "type": "object"
}

Response 200 OK

{
    "asset": "string",
    "description": "string",
    "pk": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "description": "Serializer class for the ReportAsset model.",
    "properties": {
        "asset": {
            "format": "uri",
            "type": "string"
        },
        "description": {
            "description": "Asset file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        }
    },
    "required": [
        "asset",
        "description",
        "pk"
    ],
    "type": "object"
}

PUT /api/report/asset/{id}/

Description

API endpoint for a single ReportAsset object.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"
id path integer No

Request body

{
    "asset": "string",
    "description": "string",
    "pk": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for the ReportAsset model.",
    "properties": {
        "asset": {
            "format": "uri",
            "type": "string"
        },
        "description": {
            "description": "Asset file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        }
    },
    "required": [
        "asset",
        "description",
        "pk"
    ],
    "type": "object"
}

{
    "asset": "string",
    "description": "string",
    "pk": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for the ReportAsset model.",
    "properties": {
        "asset": {
            "format": "uri",
            "type": "string"
        },
        "description": {
            "description": "Asset file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        }
    },
    "required": [
        "asset",
        "description",
        "pk"
    ],
    "type": "object"
}

{
    "asset": "string",
    "description": "string",
    "pk": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for the ReportAsset model.",
    "properties": {
        "asset": {
            "format": "uri",
            "type": "string"
        },
        "description": {
            "description": "Asset file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        }
    },
    "required": [
        "asset",
        "description",
        "pk"
    ],
    "type": "object"
}

Response 200 OK

{
    "asset": "string",
    "description": "string",
    "pk": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "description": "Serializer class for the ReportAsset model.",
    "properties": {
        "asset": {
            "format": "uri",
            "type": "string"
        },
        "description": {
            "description": "Asset file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        }
    },
    "required": [
        "asset",
        "description",
        "pk"
    ],
    "type": "object"
}

POST /api/report/print/

Description

POST action for printing a report.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"

Request body

{
    "items": [
        0
    ],
    "template": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for printing a report.",
    "properties": {
        "items": {
            "description": "List of item primary keys to include in the report",
            "items": {
                "type": "integer"
            },
            "type": "array"
        },
        "template": {
            "description": "Select report template",
            "type": "integer"
        }
    },
    "required": [
        "items",
        "template"
    ],
    "type": "object"
}

{
    "items": [
        0
    ],
    "template": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for printing a report.",
    "properties": {
        "items": {
            "description": "List of item primary keys to include in the report",
            "items": {
                "type": "integer"
            },
            "type": "array"
        },
        "template": {
            "description": "Select report template",
            "type": "integer"
        }
    },
    "required": [
        "items",
        "template"
    ],
    "type": "object"
}

{
    "items": [
        0
    ],
    "template": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for printing a report.",
    "properties": {
        "items": {
            "description": "List of item primary keys to include in the report",
            "items": {
                "type": "integer"
            },
            "type": "array"
        },
        "template": {
            "description": "Select report template",
            "type": "integer"
        }
    },
    "required": [
        "items",
        "template"
    ],
    "type": "object"
}

Response 200 OK

{
    "items": [
        0
    ],
    "template": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "description": "Serializer class for printing a report.",
    "properties": {
        "items": {
            "description": "List of item primary keys to include in the report",
            "items": {
                "type": "integer"
            },
            "type": "array"
        },
        "template": {
            "description": "Select report template",
            "type": "integer"
        }
    },
    "required": [
        "items",
        "template"
    ],
    "type": "object"
}

GET /api/report/snippet/

Description

API endpoint for listing ReportSnippet objects.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"
limit query integer No Number of results to return per page.
offset query integer No The initial index from which to return the results.

Response 200 OK

{
    "count": 123,
    "next": "http://api.example.org/accounts/?offset=400&limit=100",
    "previous": "http://api.example.org/accounts/?offset=200&limit=100",
    "results": [
        {
            "description": "string",
            "pk": 0,
            "snippet": "string"
        }
    ]
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "properties": {
        "count": {
            "example": 123,
            "type": "integer"
        },
        "next": {
            "example": "http://api.example.org/accounts/?offset=400&limit=100",
            "format": "uri",
            "nullable": true,
            "type": "string"
        },
        "previous": {
            "example": "http://api.example.org/accounts/?offset=200&limit=100",
            "format": "uri",
            "nullable": true,
            "type": "string"
        },
        "results": {
            "items": {
                "$ref": "#/components/schemas/ReportSnippet"
            },
            "type": "array"
        }
    },
    "required": [
        "count",
        "results"
    ],
    "type": "object"
}

POST /api/report/snippet/

Description

API endpoint for listing ReportSnippet objects.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"

Request body

{
    "description": "string",
    "pk": 0,
    "snippet": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for the ReportSnippet model.",
    "properties": {
        "description": {
            "description": "Snippet file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "snippet": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "pk",
        "snippet"
    ],
    "type": "object"
}

{
    "description": "string",
    "pk": 0,
    "snippet": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for the ReportSnippet model.",
    "properties": {
        "description": {
            "description": "Snippet file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "snippet": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "pk",
        "snippet"
    ],
    "type": "object"
}

{
    "description": "string",
    "pk": 0,
    "snippet": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for the ReportSnippet model.",
    "properties": {
        "description": {
            "description": "Snippet file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "snippet": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "pk",
        "snippet"
    ],
    "type": "object"
}

Response 201 Created

{
    "description": "string",
    "pk": 0,
    "snippet": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "description": "Serializer class for the ReportSnippet model.",
    "properties": {
        "description": {
            "description": "Snippet file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "snippet": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "pk",
        "snippet"
    ],
    "type": "object"
}

DELETE /api/report/snippet/{id}/

Description

API endpoint for a single ReportSnippet object.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"
id path integer No

Response 204 No Content


GET /api/report/snippet/{id}/

Description

API endpoint for a single ReportSnippet object.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"
id path integer No

Response 200 OK

{
    "description": "string",
    "pk": 0,
    "snippet": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "description": "Serializer class for the ReportSnippet model.",
    "properties": {
        "description": {
            "description": "Snippet file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "snippet": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "pk",
        "snippet"
    ],
    "type": "object"
}

PATCH /api/report/snippet/{id}/

Description

API endpoint for a single ReportSnippet object.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"
id path integer No

Request body

{
    "description": "string",
    "pk": 0,
    "snippet": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for the ReportSnippet model.",
    "properties": {
        "description": {
            "description": "Snippet file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "snippet": {
            "format": "uri",
            "type": "string"
        }
    },
    "type": "object"
}

{
    "description": "string",
    "pk": 0,
    "snippet": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for the ReportSnippet model.",
    "properties": {
        "description": {
            "description": "Snippet file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "snippet": {
            "format": "uri",
            "type": "string"
        }
    },
    "type": "object"
}

{
    "description": "string",
    "pk": 0,
    "snippet": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for the ReportSnippet model.",
    "properties": {
        "description": {
            "description": "Snippet file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "snippet": {
            "format": "uri",
            "type": "string"
        }
    },
    "type": "object"
}

Response 200 OK

{
    "description": "string",
    "pk": 0,
    "snippet": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "description": "Serializer class for the ReportSnippet model.",
    "properties": {
        "description": {
            "description": "Snippet file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "snippet": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "pk",
        "snippet"
    ],
    "type": "object"
}

PUT /api/report/snippet/{id}/

Description

API endpoint for a single ReportSnippet object.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"
id path integer No

Request body

{
    "description": "string",
    "pk": 0,
    "snippet": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for the ReportSnippet model.",
    "properties": {
        "description": {
            "description": "Snippet file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "snippet": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "pk",
        "snippet"
    ],
    "type": "object"
}

{
    "description": "string",
    "pk": 0,
    "snippet": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for the ReportSnippet model.",
    "properties": {
        "description": {
            "description": "Snippet file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "snippet": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "pk",
        "snippet"
    ],
    "type": "object"
}

{
    "description": "string",
    "pk": 0,
    "snippet": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for the ReportSnippet model.",
    "properties": {
        "description": {
            "description": "Snippet file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "snippet": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "pk",
        "snippet"
    ],
    "type": "object"
}

Response 200 OK

{
    "description": "string",
    "pk": 0,
    "snippet": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "description": "Serializer class for the ReportSnippet model.",
    "properties": {
        "description": {
            "description": "Snippet file description",
            "maxLength": 250,
            "type": "string"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "snippet": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "pk",
        "snippet"
    ],
    "type": "object"
}

GET /api/report/template/

Description

API endpoint for viewing list of ReportTemplate objects.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"
enabled query boolean No
items query string No Items
landscape query boolean No
limit query integer No Number of results to return per page.
model_type query string No Model Type * `build` - Build Order * `buildline` - Build Order Line Item * `purchaseorder` - Purchase Order * `salesorder` - Sales Order * `salesordershipment` - Sales Order Shipment * `returnorder` - Return Order * `part` - Part * `stockitem` - Stock Item * `stocklocation` - Stock Location
offset query integer No The initial index from which to return the results.
search query string No A search term.

Response 200 OK

{
    "count": 123,
    "next": "http://api.example.org/accounts/?offset=400&limit=100",
    "previous": "http://api.example.org/accounts/?offset=200&limit=100",
    "results": [
        {
            "attach_to_model": true,
            "description": "string",
            "enabled": true,
            "filename_pattern": "string",
            "filters": "string",
            "landscape": true,
            "model_type": "build",
            "name": "string",
            "page_size": null,
            "pk": 0,
            "revision": 0,
            "template": "string"
        }
    ]
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "properties": {
        "count": {
            "example": 123,
            "type": "integer"
        },
        "next": {
            "example": "http://api.example.org/accounts/?offset=400&limit=100",
            "format": "uri",
            "nullable": true,
            "type": "string"
        },
        "previous": {
            "example": "http://api.example.org/accounts/?offset=200&limit=100",
            "format": "uri",
            "nullable": true,
            "type": "string"
        },
        "results": {
            "items": {
                "$ref": "#/components/schemas/ReportTemplate"
            },
            "type": "array"
        }
    },
    "required": [
        "count",
        "results"
    ],
    "type": "object"
}

POST /api/report/template/

Description

API endpoint for viewing list of ReportTemplate objects.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"

Request body

{
    "attach_to_model": true,
    "description": "string",
    "enabled": true,
    "filename_pattern": "string",
    "filters": "string",
    "landscape": true,
    "model_type": "build",
    "name": "string",
    "page_size": null,
    "pk": 0,
    "revision": 0,
    "template": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for report template model.",
    "properties": {
        "attach_to_model": {
            "description": "Save report output as an attachment against linked model instance when printing",
            "title": "Attach to Model on Print",
            "type": "boolean"
        },
        "description": {
            "description": "Template description",
            "maxLength": 250,
            "type": "string"
        },
        "enabled": {
            "description": "Template is enabled",
            "type": "boolean"
        },
        "filename_pattern": {
            "description": "Pattern for generating filenames",
            "maxLength": 100,
            "type": "string"
        },
        "filters": {
            "description": "Template query filters (comma-separated list of key=value pairs)",
            "maxLength": 250,
            "type": "string"
        },
        "landscape": {
            "description": "Render report in landscape orientation",
            "type": "boolean"
        },
        "model_type": {
            "$ref": "#/components/schemas/TemplateModelTypeEnum"
        },
        "name": {
            "description": "Template name",
            "maxLength": 100,
            "type": "string"
        },
        "page_size": {
            "allOf": [
                {
                    "$ref": "#/components/schemas/PageSizeEnum"
                }
            ],
            "default": "A4"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "revision": {
            "readOnly": true,
            "type": "integer"
        },
        "template": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "model_type",
        "name",
        "pk",
        "revision",
        "template"
    ],
    "type": "object"
}

{
    "attach_to_model": true,
    "description": "string",
    "enabled": true,
    "filename_pattern": "string",
    "filters": "string",
    "landscape": true,
    "model_type": "build",
    "name": "string",
    "page_size": null,
    "pk": 0,
    "revision": 0,
    "template": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for report template model.",
    "properties": {
        "attach_to_model": {
            "description": "Save report output as an attachment against linked model instance when printing",
            "title": "Attach to Model on Print",
            "type": "boolean"
        },
        "description": {
            "description": "Template description",
            "maxLength": 250,
            "type": "string"
        },
        "enabled": {
            "description": "Template is enabled",
            "type": "boolean"
        },
        "filename_pattern": {
            "description": "Pattern for generating filenames",
            "maxLength": 100,
            "type": "string"
        },
        "filters": {
            "description": "Template query filters (comma-separated list of key=value pairs)",
            "maxLength": 250,
            "type": "string"
        },
        "landscape": {
            "description": "Render report in landscape orientation",
            "type": "boolean"
        },
        "model_type": {
            "$ref": "#/components/schemas/TemplateModelTypeEnum"
        },
        "name": {
            "description": "Template name",
            "maxLength": 100,
            "type": "string"
        },
        "page_size": {
            "allOf": [
                {
                    "$ref": "#/components/schemas/PageSizeEnum"
                }
            ],
            "default": "A4"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "revision": {
            "readOnly": true,
            "type": "integer"
        },
        "template": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "model_type",
        "name",
        "pk",
        "revision",
        "template"
    ],
    "type": "object"
}

{
    "attach_to_model": true,
    "description": "string",
    "enabled": true,
    "filename_pattern": "string",
    "filters": "string",
    "landscape": true,
    "model_type": "build",
    "name": "string",
    "page_size": null,
    "pk": 0,
    "revision": 0,
    "template": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for report template model.",
    "properties": {
        "attach_to_model": {
            "description": "Save report output as an attachment against linked model instance when printing",
            "title": "Attach to Model on Print",
            "type": "boolean"
        },
        "description": {
            "description": "Template description",
            "maxLength": 250,
            "type": "string"
        },
        "enabled": {
            "description": "Template is enabled",
            "type": "boolean"
        },
        "filename_pattern": {
            "description": "Pattern for generating filenames",
            "maxLength": 100,
            "type": "string"
        },
        "filters": {
            "description": "Template query filters (comma-separated list of key=value pairs)",
            "maxLength": 250,
            "type": "string"
        },
        "landscape": {
            "description": "Render report in landscape orientation",
            "type": "boolean"
        },
        "model_type": {
            "$ref": "#/components/schemas/TemplateModelTypeEnum"
        },
        "name": {
            "description": "Template name",
            "maxLength": 100,
            "type": "string"
        },
        "page_size": {
            "allOf": [
                {
                    "$ref": "#/components/schemas/PageSizeEnum"
                }
            ],
            "default": "A4"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "revision": {
            "readOnly": true,
            "type": "integer"
        },
        "template": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "model_type",
        "name",
        "pk",
        "revision",
        "template"
    ],
    "type": "object"
}

Response 201 Created

{
    "attach_to_model": true,
    "description": "string",
    "enabled": true,
    "filename_pattern": "string",
    "filters": "string",
    "landscape": true,
    "model_type": "build",
    "name": "string",
    "page_size": null,
    "pk": 0,
    "revision": 0,
    "template": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "description": "Serializer class for report template model.",
    "properties": {
        "attach_to_model": {
            "description": "Save report output as an attachment against linked model instance when printing",
            "title": "Attach to Model on Print",
            "type": "boolean"
        },
        "description": {
            "description": "Template description",
            "maxLength": 250,
            "type": "string"
        },
        "enabled": {
            "description": "Template is enabled",
            "type": "boolean"
        },
        "filename_pattern": {
            "description": "Pattern for generating filenames",
            "maxLength": 100,
            "type": "string"
        },
        "filters": {
            "description": "Template query filters (comma-separated list of key=value pairs)",
            "maxLength": 250,
            "type": "string"
        },
        "landscape": {
            "description": "Render report in landscape orientation",
            "type": "boolean"
        },
        "model_type": {
            "$ref": "#/components/schemas/TemplateModelTypeEnum"
        },
        "name": {
            "description": "Template name",
            "maxLength": 100,
            "type": "string"
        },
        "page_size": {
            "allOf": [
                {
                    "$ref": "#/components/schemas/PageSizeEnum"
                }
            ],
            "default": "A4"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "revision": {
            "readOnly": true,
            "type": "integer"
        },
        "template": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "model_type",
        "name",
        "pk",
        "revision",
        "template"
    ],
    "type": "object"
}

DELETE /api/report/template/{id}/

Description

Detail API endpoint for report template model.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"
id path integer No

Response 204 No Content


GET /api/report/template/{id}/

Description

Detail API endpoint for report template model.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"
id path integer No

Response 200 OK

{
    "attach_to_model": true,
    "description": "string",
    "enabled": true,
    "filename_pattern": "string",
    "filters": "string",
    "landscape": true,
    "model_type": "build",
    "name": "string",
    "page_size": null,
    "pk": 0,
    "revision": 0,
    "template": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "description": "Serializer class for report template model.",
    "properties": {
        "attach_to_model": {
            "description": "Save report output as an attachment against linked model instance when printing",
            "title": "Attach to Model on Print",
            "type": "boolean"
        },
        "description": {
            "description": "Template description",
            "maxLength": 250,
            "type": "string"
        },
        "enabled": {
            "description": "Template is enabled",
            "type": "boolean"
        },
        "filename_pattern": {
            "description": "Pattern for generating filenames",
            "maxLength": 100,
            "type": "string"
        },
        "filters": {
            "description": "Template query filters (comma-separated list of key=value pairs)",
            "maxLength": 250,
            "type": "string"
        },
        "landscape": {
            "description": "Render report in landscape orientation",
            "type": "boolean"
        },
        "model_type": {
            "$ref": "#/components/schemas/TemplateModelTypeEnum"
        },
        "name": {
            "description": "Template name",
            "maxLength": 100,
            "type": "string"
        },
        "page_size": {
            "allOf": [
                {
                    "$ref": "#/components/schemas/PageSizeEnum"
                }
            ],
            "default": "A4"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "revision": {
            "readOnly": true,
            "type": "integer"
        },
        "template": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "model_type",
        "name",
        "pk",
        "revision",
        "template"
    ],
    "type": "object"
}

PATCH /api/report/template/{id}/

Description

Detail API endpoint for report template model.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"
id path integer No

Request body

{
    "attach_to_model": true,
    "description": "string",
    "enabled": true,
    "filename_pattern": "string",
    "filters": "string",
    "landscape": true,
    "model_type": "build",
    "name": "string",
    "page_size": null,
    "pk": 0,
    "revision": 0,
    "template": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for report template model.",
    "properties": {
        "attach_to_model": {
            "description": "Save report output as an attachment against linked model instance when printing",
            "title": "Attach to Model on Print",
            "type": "boolean"
        },
        "description": {
            "description": "Template description",
            "maxLength": 250,
            "type": "string"
        },
        "enabled": {
            "description": "Template is enabled",
            "type": "boolean"
        },
        "filename_pattern": {
            "description": "Pattern for generating filenames",
            "maxLength": 100,
            "type": "string"
        },
        "filters": {
            "description": "Template query filters (comma-separated list of key=value pairs)",
            "maxLength": 250,
            "type": "string"
        },
        "landscape": {
            "description": "Render report in landscape orientation",
            "type": "boolean"
        },
        "model_type": {
            "$ref": "#/components/schemas/TemplateModelTypeEnum"
        },
        "name": {
            "description": "Template name",
            "maxLength": 100,
            "type": "string"
        },
        "page_size": {
            "allOf": [
                {
                    "$ref": "#/components/schemas/PageSizeEnum"
                }
            ],
            "default": "A4"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "revision": {
            "readOnly": true,
            "type": "integer"
        },
        "template": {
            "format": "uri",
            "type": "string"
        }
    },
    "type": "object"
}

{
    "attach_to_model": true,
    "description": "string",
    "enabled": true,
    "filename_pattern": "string",
    "filters": "string",
    "landscape": true,
    "model_type": "build",
    "name": "string",
    "page_size": null,
    "pk": 0,
    "revision": 0,
    "template": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for report template model.",
    "properties": {
        "attach_to_model": {
            "description": "Save report output as an attachment against linked model instance when printing",
            "title": "Attach to Model on Print",
            "type": "boolean"
        },
        "description": {
            "description": "Template description",
            "maxLength": 250,
            "type": "string"
        },
        "enabled": {
            "description": "Template is enabled",
            "type": "boolean"
        },
        "filename_pattern": {
            "description": "Pattern for generating filenames",
            "maxLength": 100,
            "type": "string"
        },
        "filters": {
            "description": "Template query filters (comma-separated list of key=value pairs)",
            "maxLength": 250,
            "type": "string"
        },
        "landscape": {
            "description": "Render report in landscape orientation",
            "type": "boolean"
        },
        "model_type": {
            "$ref": "#/components/schemas/TemplateModelTypeEnum"
        },
        "name": {
            "description": "Template name",
            "maxLength": 100,
            "type": "string"
        },
        "page_size": {
            "allOf": [
                {
                    "$ref": "#/components/schemas/PageSizeEnum"
                }
            ],
            "default": "A4"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "revision": {
            "readOnly": true,
            "type": "integer"
        },
        "template": {
            "format": "uri",
            "type": "string"
        }
    },
    "type": "object"
}

{
    "attach_to_model": true,
    "description": "string",
    "enabled": true,
    "filename_pattern": "string",
    "filters": "string",
    "landscape": true,
    "model_type": "build",
    "name": "string",
    "page_size": null,
    "pk": 0,
    "revision": 0,
    "template": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for report template model.",
    "properties": {
        "attach_to_model": {
            "description": "Save report output as an attachment against linked model instance when printing",
            "title": "Attach to Model on Print",
            "type": "boolean"
        },
        "description": {
            "description": "Template description",
            "maxLength": 250,
            "type": "string"
        },
        "enabled": {
            "description": "Template is enabled",
            "type": "boolean"
        },
        "filename_pattern": {
            "description": "Pattern for generating filenames",
            "maxLength": 100,
            "type": "string"
        },
        "filters": {
            "description": "Template query filters (comma-separated list of key=value pairs)",
            "maxLength": 250,
            "type": "string"
        },
        "landscape": {
            "description": "Render report in landscape orientation",
            "type": "boolean"
        },
        "model_type": {
            "$ref": "#/components/schemas/TemplateModelTypeEnum"
        },
        "name": {
            "description": "Template name",
            "maxLength": 100,
            "type": "string"
        },
        "page_size": {
            "allOf": [
                {
                    "$ref": "#/components/schemas/PageSizeEnum"
                }
            ],
            "default": "A4"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "revision": {
            "readOnly": true,
            "type": "integer"
        },
        "template": {
            "format": "uri",
            "type": "string"
        }
    },
    "type": "object"
}

Response 200 OK

{
    "attach_to_model": true,
    "description": "string",
    "enabled": true,
    "filename_pattern": "string",
    "filters": "string",
    "landscape": true,
    "model_type": "build",
    "name": "string",
    "page_size": null,
    "pk": 0,
    "revision": 0,
    "template": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "description": "Serializer class for report template model.",
    "properties": {
        "attach_to_model": {
            "description": "Save report output as an attachment against linked model instance when printing",
            "title": "Attach to Model on Print",
            "type": "boolean"
        },
        "description": {
            "description": "Template description",
            "maxLength": 250,
            "type": "string"
        },
        "enabled": {
            "description": "Template is enabled",
            "type": "boolean"
        },
        "filename_pattern": {
            "description": "Pattern for generating filenames",
            "maxLength": 100,
            "type": "string"
        },
        "filters": {
            "description": "Template query filters (comma-separated list of key=value pairs)",
            "maxLength": 250,
            "type": "string"
        },
        "landscape": {
            "description": "Render report in landscape orientation",
            "type": "boolean"
        },
        "model_type": {
            "$ref": "#/components/schemas/TemplateModelTypeEnum"
        },
        "name": {
            "description": "Template name",
            "maxLength": 100,
            "type": "string"
        },
        "page_size": {
            "allOf": [
                {
                    "$ref": "#/components/schemas/PageSizeEnum"
                }
            ],
            "default": "A4"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "revision": {
            "readOnly": true,
            "type": "integer"
        },
        "template": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "model_type",
        "name",
        "pk",
        "revision",
        "template"
    ],
    "type": "object"
}

PUT /api/report/template/{id}/

Description

Detail API endpoint for report template model.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"
id path integer No

Request body

{
    "attach_to_model": true,
    "description": "string",
    "enabled": true,
    "filename_pattern": "string",
    "filters": "string",
    "landscape": true,
    "model_type": "build",
    "name": "string",
    "page_size": null,
    "pk": 0,
    "revision": 0,
    "template": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for report template model.",
    "properties": {
        "attach_to_model": {
            "description": "Save report output as an attachment against linked model instance when printing",
            "title": "Attach to Model on Print",
            "type": "boolean"
        },
        "description": {
            "description": "Template description",
            "maxLength": 250,
            "type": "string"
        },
        "enabled": {
            "description": "Template is enabled",
            "type": "boolean"
        },
        "filename_pattern": {
            "description": "Pattern for generating filenames",
            "maxLength": 100,
            "type": "string"
        },
        "filters": {
            "description": "Template query filters (comma-separated list of key=value pairs)",
            "maxLength": 250,
            "type": "string"
        },
        "landscape": {
            "description": "Render report in landscape orientation",
            "type": "boolean"
        },
        "model_type": {
            "$ref": "#/components/schemas/TemplateModelTypeEnum"
        },
        "name": {
            "description": "Template name",
            "maxLength": 100,
            "type": "string"
        },
        "page_size": {
            "allOf": [
                {
                    "$ref": "#/components/schemas/PageSizeEnum"
                }
            ],
            "default": "A4"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "revision": {
            "readOnly": true,
            "type": "integer"
        },
        "template": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "model_type",
        "name",
        "pk",
        "revision",
        "template"
    ],
    "type": "object"
}

{
    "attach_to_model": true,
    "description": "string",
    "enabled": true,
    "filename_pattern": "string",
    "filters": "string",
    "landscape": true,
    "model_type": "build",
    "name": "string",
    "page_size": null,
    "pk": 0,
    "revision": 0,
    "template": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for report template model.",
    "properties": {
        "attach_to_model": {
            "description": "Save report output as an attachment against linked model instance when printing",
            "title": "Attach to Model on Print",
            "type": "boolean"
        },
        "description": {
            "description": "Template description",
            "maxLength": 250,
            "type": "string"
        },
        "enabled": {
            "description": "Template is enabled",
            "type": "boolean"
        },
        "filename_pattern": {
            "description": "Pattern for generating filenames",
            "maxLength": 100,
            "type": "string"
        },
        "filters": {
            "description": "Template query filters (comma-separated list of key=value pairs)",
            "maxLength": 250,
            "type": "string"
        },
        "landscape": {
            "description": "Render report in landscape orientation",
            "type": "boolean"
        },
        "model_type": {
            "$ref": "#/components/schemas/TemplateModelTypeEnum"
        },
        "name": {
            "description": "Template name",
            "maxLength": 100,
            "type": "string"
        },
        "page_size": {
            "allOf": [
                {
                    "$ref": "#/components/schemas/PageSizeEnum"
                }
            ],
            "default": "A4"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "revision": {
            "readOnly": true,
            "type": "integer"
        },
        "template": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "model_type",
        "name",
        "pk",
        "revision",
        "template"
    ],
    "type": "object"
}

{
    "attach_to_model": true,
    "description": "string",
    "enabled": true,
    "filename_pattern": "string",
    "filters": "string",
    "landscape": true,
    "model_type": "build",
    "name": "string",
    "page_size": null,
    "pk": 0,
    "revision": 0,
    "template": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for report template model.",
    "properties": {
        "attach_to_model": {
            "description": "Save report output as an attachment against linked model instance when printing",
            "title": "Attach to Model on Print",
            "type": "boolean"
        },
        "description": {
            "description": "Template description",
            "maxLength": 250,
            "type": "string"
        },
        "enabled": {
            "description": "Template is enabled",
            "type": "boolean"
        },
        "filename_pattern": {
            "description": "Pattern for generating filenames",
            "maxLength": 100,
            "type": "string"
        },
        "filters": {
            "description": "Template query filters (comma-separated list of key=value pairs)",
            "maxLength": 250,
            "type": "string"
        },
        "landscape": {
            "description": "Render report in landscape orientation",
            "type": "boolean"
        },
        "model_type": {
            "$ref": "#/components/schemas/TemplateModelTypeEnum"
        },
        "name": {
            "description": "Template name",
            "maxLength": 100,
            "type": "string"
        },
        "page_size": {
            "allOf": [
                {
                    "$ref": "#/components/schemas/PageSizeEnum"
                }
            ],
            "default": "A4"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "revision": {
            "readOnly": true,
            "type": "integer"
        },
        "template": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "model_type",
        "name",
        "pk",
        "revision",
        "template"
    ],
    "type": "object"
}

Response 200 OK

{
    "attach_to_model": true,
    "description": "string",
    "enabled": true,
    "filename_pattern": "string",
    "filters": "string",
    "landscape": true,
    "model_type": "build",
    "name": "string",
    "page_size": null,
    "pk": 0,
    "revision": 0,
    "template": "string"
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "description": "Serializer class for report template model.",
    "properties": {
        "attach_to_model": {
            "description": "Save report output as an attachment against linked model instance when printing",
            "title": "Attach to Model on Print",
            "type": "boolean"
        },
        "description": {
            "description": "Template description",
            "maxLength": 250,
            "type": "string"
        },
        "enabled": {
            "description": "Template is enabled",
            "type": "boolean"
        },
        "filename_pattern": {
            "description": "Pattern for generating filenames",
            "maxLength": 100,
            "type": "string"
        },
        "filters": {
            "description": "Template query filters (comma-separated list of key=value pairs)",
            "maxLength": 250,
            "type": "string"
        },
        "landscape": {
            "description": "Render report in landscape orientation",
            "type": "boolean"
        },
        "model_type": {
            "$ref": "#/components/schemas/TemplateModelTypeEnum"
        },
        "name": {
            "description": "Template name",
            "maxLength": 100,
            "type": "string"
        },
        "page_size": {
            "allOf": [
                {
                    "$ref": "#/components/schemas/PageSizeEnum"
                }
            ],
            "default": "A4"
        },
        "pk": {
            "readOnly": true,
            "title": "ID",
            "type": "integer"
        },
        "revision": {
            "readOnly": true,
            "type": "integer"
        },
        "template": {
            "format": "uri",
            "type": "string"
        }
    },
    "required": [
        "description",
        "model_type",
        "name",
        "pk",
        "revision",
        "template"
    ],
    "type": "object"
}

GET /api/report/template/{id}/metadata/

Description

Generic API endpoint for reading and editing metadata for a model.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"
id path integer No

Response 200 OK

{
    "metadata": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "description": "Serializer class for model metadata API access.",
    "properties": {
        "metadata": {}
    },
    "required": [
        "metadata"
    ],
    "type": "object"
}

PATCH /api/report/template/{id}/metadata/

Description

Generic API endpoint for reading and editing metadata for a model.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"
id path integer No

Request body

{
    "metadata": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for model metadata API access.",
    "properties": {
        "metadata": {}
    },
    "type": "object"
}

{
    "metadata": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for model metadata API access.",
    "properties": {
        "metadata": {}
    },
    "type": "object"
}

{
    "metadata": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for model metadata API access.",
    "properties": {
        "metadata": {}
    },
    "type": "object"
}

Response 200 OK

{
    "metadata": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "description": "Serializer class for model metadata API access.",
    "properties": {
        "metadata": {}
    },
    "required": [
        "metadata"
    ],
    "type": "object"
}

PUT /api/report/template/{id}/metadata/

Description

Generic API endpoint for reading and editing metadata for a model.

Input parameters

Parameter In Type Default Nullable Description
oauth2 header string N/A No
cookieAuth cookie string N/A No API key
basicAuth header string N/A No Basic authentication
tokenAuth header string N/A No Token-based authentication with required prefix "Token"
id path integer No

Request body

{
    "metadata": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for model metadata API access.",
    "properties": {
        "metadata": {}
    },
    "required": [
        "metadata"
    ],
    "type": "object"
}

{
    "metadata": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for model metadata API access.",
    "properties": {
        "metadata": {}
    },
    "required": [
        "metadata"
    ],
    "type": "object"
}

{
    "metadata": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "description": "Serializer class for model metadata API access.",
    "properties": {
        "metadata": {}
    },
    "required": [
        "metadata"
    ],
    "type": "object"
}

Response 200 OK

{
    "metadata": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "description": "Serializer class for model metadata API access.",
    "properties": {
        "metadata": {}
    },
    "required": [
        "metadata"
    ],
    "type": "object"
}

Schemas

Metadata

Name Type
metadata

PageSizeEnum

Type: string

PaginatedReportAssetList

Name Type
count integer
next string(uri)| null
previous string(uri)| null
results Array<ReportAsset>

PaginatedReportSnippetList

Name Type
count integer
next string(uri)| null
previous string(uri)| null
results Array<ReportSnippet>

PaginatedReportTemplateList

Name Type
count integer
next string(uri)| null
previous string(uri)| null
results Array<ReportTemplate>

PatchedMetadata

Name Type
metadata

PatchedReportAsset

Name Type
asset string(uri)
description string
pk integer

PatchedReportSnippet

Name Type
description string
pk integer
snippet string(uri)

PatchedReportTemplate

Name Type
attach_to_model boolean
description string
enabled boolean
filename_pattern string
filters string
landscape boolean
model_type TemplateModelTypeEnum
name string
page_size
pk integer
revision integer
template string(uri)

ReportAsset

Name Type
asset string(uri)
description string
pk integer

ReportPrint

Name Type
items Array<integer>
template integer

ReportSnippet

Name Type
description string
pk integer
snippet string(uri)

ReportTemplate

Name Type
attach_to_model boolean
description string
enabled boolean
filename_pattern string
filters string
landscape boolean
model_type TemplateModelTypeEnum
name string
page_size
pk integer
revision integer
template string(uri)

TemplateModelTypeEnum

Type: string

Common responses

This section describes common responses that are reused across operations.

allauth.AddAuthenticatorConflict

The account prohibits adding an authenticator, e.g. because of an unverified email address.

Schema of the response body
null

allauth.AddWebAuthnAuthenticator

A WebAuthn authenticator.

{
    "data": null,
    "meta": {
        "recovery_codes_generated": true
    },
    "status": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "properties": {
        "data": {
            "$ref": "#/components/schemas/allauth.WebAuthnAuthenticator"
        },
        "meta": {
            "properties": {
                "recovery_codes_generated": {
                    "description": "Whether or not recovery codes where generated automatically.\n",
                    "type": "boolean"
                }
            },
            "type": "object"
        },
        "status": {
            "$ref": "#/components/schemas/allauth.StatusOK"
        }
    },
    "required": [
        "status",
        "data",
        "meta"
    ],
    "type": "object"
}

allauth.Authenticated

The user is authenticated.

Schema of the response body
null

allauth.AuthenticatedByCode

Authenticated by code.

{
    "summary": "Authenticated by code.\n",
    "value": {
        "data": {
            "methods": [
                {
                    "at": 1711555057.065702,
                    "email": "email@domain.org",
                    "method": "code"
                }
            ],
            "user": {
                "display": "wizard",
                "email": "email@domain.org",
                "has_usable_password": true,
                "id": 123,
                "username": "wizard"
            }
        },
        "meta": {
            "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdW",
            "is_authenticated": true,
            "session_token": "ufwcig0zen9skyd545jc0fkq813ghar2"
        },
        "status": 200
    }
}
Schema of the response body
null

allauth.AuthenticatedByPassword

Authenticated by password.

{
    "summary": "Authenticated by password.\n",
    "value": {
        "data": {
            "methods": [
                {
                    "at": 1711555057.065702,
                    "email": "email@domain.org",
                    "method": "password"
                }
            ],
            "user": {
                "display": "wizard",
                "email": "email@domain.org",
                "has_usable_password": true,
                "id": 123,
                "username": "wizard"
            }
        },
        "meta": {
            "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdW",
            "is_authenticated": true,
            "session_token": "ufwcig0zen9skyd545jc0fkq813ghar2"
        },
        "status": 200
    }
}
Schema of the response body
null

allauth.AuthenticatedByPasswordAnd2FA

Authenticated by password and 2FA.

{
    "summary": "Fully authenticated using by password and 2FA.\n",
    "value": {
        "data": {
            "methods": [
                {
                    "at": 1711555057.065702,
                    "email": "email@domain.org",
                    "method": "password"
                },
                {
                    "at": 1711555060.9375854,
                    "id": 66,
                    "method": "mfa",
                    "type": "totp"
                }
            ],
            "user": {
                "display": "Magic Wizard",
                "email": "email@domain.org",
                "has_usable_password": true,
                "id": 123,
                "username": "wizard"
            }
        },
        "meta": {
            "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdW",
            "is_authenticated": true,
            "session_token": "ufwcig0zen9skyd545jc0fkq813ghar2"
        },
        "status": 200
    }
}
Schema of the response body
null

allauth.Authentication

Not authenticated.

{
    "summary": "Reauthentication required\n",
    "value": {
        "data": {
            "flows": [
                {
                    "id": "reauthenticate"
                },
                {
                    "id": "mfa_reauthenticate"
                }
            ],
            "methods": [
                {
                    "at": 1711555057.065702,
                    "email": "email@domain.org",
                    "method": "password"
                },
                {
                    "at": 1711555060.9375854,
                    "id": 66,
                    "method": "mfa",
                    "type": "totp"
                }
            ],
            "user": {
                "display": "wizard",
                "email": "email@domain.org",
                "has_usable_password": true,
                "id": 123,
                "username": "wizard"
            }
        },
        "meta": {
            "is_authenticated": true
        },
        "status": 401
    }
}
{
    "summary": "Unauthenticated: Initial\n",
    "value": {
        "data": {
            "flows": [
                {
                    "id": "login"
                },
                {
                    "id": "signup"
                },
                {
                    "id": "provider_redirect",
                    "providers": [
                        "facebook",
                        "google",
                        "telegram"
                    ]
                },
                {
                    "id": "provider_token",
                    "providers": [
                        "google"
                    ]
                }
            ]
        },
        "meta": {
            "is_authenticated": false
        },
        "status": 401
    }
}
{
    "summary": "Unauthenticated: pending 2FA\n",
    "value": {
        "data": {
            "flows": [
                {
                    "id": "login"
                },
                {
                    "id": "signup"
                },
                {
                    "id": "provider_redirect",
                    "providers": [
                        "facebook",
                        "google",
                        "telegram"
                    ]
                },
                {
                    "id": "provider_token",
                    "providers": [
                        "google"
                    ]
                },
                {
                    "id": "mfa_authenticate",
                    "is_pending": true
                }
            ]
        },
        "meta": {
            "is_authenticated": false
        },
        "status": 401
    }
}
{
    "summary": "Unauthenticated: pending email verification\n",
    "value": {
        "data": {
            "flows": [
                {
                    "id": "login"
                },
                {
                    "id": "signup"
                },
                {
                    "id": "provider_redirect",
                    "providers": [
                        "facebook",
                        "google",
                        "telegram"
                    ]
                },
                {
                    "id": "provider_token",
                    "providers": [
                        "google"
                    ]
                },
                {
                    "id": "verify_email",
                    "is_pending": true
                }
            ]
        },
        "meta": {
            "is_authenticated": false
        },
        "status": 401
    }
}
{
    "summary": "Unauthenticated: pending provider signup\n",
    "value": {
        "data": {
            "flows": [
                {
                    "id": "login"
                },
                {
                    "id": "signup"
                },
                {
                    "id": "provider_redirect",
                    "providers": [
                        "facebook",
                        "google",
                        "telegram"
                    ]
                },
                {
                    "id": "provider_token",
                    "providers": [
                        "google"
                    ]
                },
                {
                    "id": "provider_signup",
                    "is_pending": true,
                    "provider": {
                        "client_id": "123.apps.googleusercontent.com",
                        "flows": [
                            "provider_redirect",
                            "provider_token"
                        ],
                        "id": "google",
                        "name": "Google"
                    }
                }
            ]
        },
        "meta": {
            "is_authenticated": false
        },
        "status": 401
    }
}
Schema of the response body
null

allauth.AuthenticationOrReauthentication

The response indicates authentication or re-authentication is required.

Schema of the response body
{
    "oneOf": [
        {
            "$ref": "#/components/schemas/allauth.AuthenticationResponse"
        },
        {
            "$ref": "#/components/schemas/allauth.ReauthenticationResponse"
        }
    ]
}

allauth.Authenticators

List of authenticators.

{
    "data": null,
    "status": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "properties": {
        "data": {
            "$ref": "#/components/schemas/allauth.AuthenticatorList"
        },
        "status": {
            "$ref": "#/components/schemas/allauth.StatusOK"
        }
    },
    "required": [
        "status",
        "data"
    ],
    "type": "object"
}

allauth.Configuration

The django-allauth configuration.

Schema of the response body
null

allauth.EmailAddresses

List of email addresses.

{
    "data": [
        null
    ],
    "status": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "properties": {
        "data": {
            "items": {
                "$ref": "#/components/schemas/allauth.EmailAddress"
            },
            "type": "array"
        },
        "status": {
            "$ref": "#/components/schemas/allauth.StatusOK"
        }
    },
    "required": [
        "status",
        "data"
    ],
    "type": "object"
}

allauth.EmailVerificationInfo

Email verification information.

Schema of the response body
null

allauth.Error

An input error occurred.

Schema of the response body
null

allauth.Forbidden

A forbidden response.

Schema of the response body
null

allauth.NotFound

Not found.

{
    "status": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "properties": {
        "status": {
            "enum": [
                404
            ],
            "type": "integer"
        }
    },
    "required": [
        "status"
    ],
    "type": "object"
}

allauth.PasswordResetInfo

Information about the password reset key.

{
    "data": {
        "user": null
    },
    "status": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "properties": {
        "data": {
            "properties": {
                "user": {
                    "$ref": "#/components/schemas/allauth.User"
                }
            },
            "type": "object"
        },
        "status": {
            "$ref": "#/components/schemas/allauth.StatusOK"
        }
    },
    "required": [
        "status",
        "data"
    ],
    "type": "object"
}

allauth.ProviderAccounts

List of third-party provider accounts.

{
    "data": [
        null
    ],
    "status": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "properties": {
        "data": {
            "items": {
                "$ref": "#/components/schemas/allauth.ProviderAccount"
            },
            "type": "array"
        },
        "status": {
            "$ref": "#/components/schemas/allauth.StatusOK"
        }
    },
    "required": [
        "status",
        "data"
    ],
    "type": "object"
}

allauth.ReauthenticationRequired

The response indicates reauthentication is required.

{
    "data": {
        "flows": [
            {
                "id": "reauthenticate"
            },
            {
                "id": "mfa_reauthenticate"
            }
        ],
        "methods": [
            {
                "at": 1711555057.065702,
                "email": "email@domain.org",
                "method": "password"
            },
            {
                "at": 1711555060.9375854,
                "id": 66,
                "method": "mfa",
                "type": "totp"
            }
        ],
        "user": {
            "display": "wizard",
            "email": "email@domain.org",
            "has_usable_password": true,
            "id": 123,
            "username": "wizard"
        }
    },
    "meta": {
        "is_authenticated": true
    },
    "status": 401
}
Schema of the response body

allauth.RecoveryCodes

Information on the recovery codes.

{
    "data": null,
    "status": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "properties": {
        "data": {
            "$ref": "#/components/schemas/allauth.SensitiveRecoveryCodesAuthenticator"
        },
        "status": {
            "$ref": "#/components/schemas/allauth.StatusOK"
        }
    },
    "required": [
        "status",
        "data"
    ],
    "type": "object"
}

allauth.SessionGone

The response indicates session is invalid or no longer exists.

{
    "summary": "Unauthenticated: Initial\n",
    "value": {
        "data": {
            "flows": [
                {
                    "id": "login"
                },
                {
                    "id": "signup"
                },
                {
                    "id": "provider_redirect",
                    "providers": [
                        "facebook",
                        "google",
                        "telegram"
                    ]
                },
                {
                    "id": "provider_token",
                    "providers": [
                        "google"
                    ]
                }
            ]
        },
        "meta": {
            "is_authenticated": false
        },
        "status": 401
    }
}
Schema of the response body
null

allauth.Sessions

List of sessions.

{
    "data": [
        null
    ],
    "status": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "properties": {
        "data": {
            "items": {
                "$ref": "#/components/schemas/allauth.Session"
            },
            "type": "array"
        },
        "status": {
            "$ref": "#/components/schemas/allauth.StatusOK"
        }
    },
    "required": [
        "status",
        "data"
    ],
    "type": "object"
}

allauth.StatusOK

A success response.

{
    "status": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "properties": {
        "status": {
            "$ref": "#/components/schemas/allauth.StatusOK"
        }
    },
    "required": [
        "status"
    ],
    "type": "object"
}

allauth.TOTPAuthenticator

Information on the TOTP authenticator.

{
    "data": null,
    "status": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "properties": {
        "data": {
            "$ref": "#/components/schemas/allauth.TOTPAuthenticator"
        },
        "status": {
            "$ref": "#/components/schemas/allauth.StatusOK"
        }
    },
    "required": [
        "status",
        "data"
    ],
    "type": "object"
}

allauth.TOTPAuthenticatorNotFound

No TOTP authenticator has been set up.

{
    "meta": {
        "secret": "J4ZKKXTK7NOVU7EPUVY23LCDV4T2QZYM",
        "totp_url": "otpauth://totp/Example:alice@fsf.org?secret=JBSWY3DPEHPK3PXP&issuer=Example"
    },
    "status": 0
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "properties": {
        "meta": {
            "properties": {
                "secret": {
                    "description": "A TOTP secret that can be used to setup a new authenticator.\n",
                    "example": "J4ZKKXTK7NOVU7EPUVY23LCDV4T2QZYM",
                    "type": "string"
                },
                "totp_url": {
                    "description": "otpauth URI from which a QR code can be generated and scanned by OTP clients.\n",
                    "example": "otpauth://totp/Example:alice@fsf.org?secret=JBSWY3DPEHPK3PXP&issuer=Example",
                    "type": "string"
                }
            },
            "required": [
                "secret",
                "totp_url"
            ],
            "type": "object"
        },
        "status": {
            "enum": [
                404
            ],
            "type": "integer"
        }
    },
    "required": [
        "status",
        "meta"
    ],
    "type": "object"
}

allauth.Unauthenticated

There is no authenticated session.

{
    "summary": "Unauthenticated: Initial\n",
    "value": {
        "data": {
            "flows": [
                {
                    "id": "login"
                },
                {
                    "id": "signup"
                },
                {
                    "id": "provider_redirect",
                    "providers": [
                        "facebook",
                        "google",
                        "telegram"
                    ]
                },
                {
                    "id": "provider_token",
                    "providers": [
                        "google"
                    ]
                }
            ]
        },
        "meta": {
            "is_authenticated": false
        },
        "status": 401
    }
}
Schema of the response body
null

allauth.WebAuthnAuthenticator

A WebAuthn authenticator.

{
    "data": null,
    "status": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "properties": {
        "data": {
            "$ref": "#/components/schemas/allauth.WebAuthnAuthenticator"
        },
        "status": {
            "$ref": "#/components/schemas/allauth.StatusOK"
        }
    },
    "required": [
        "status",
        "data"
    ],
    "type": "object"
}

allauth.WebAuthnCreationOptionsResponse

WebAuthn credential creation options.

{
    "data": null,
    "status": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "properties": {
        "data": {
            "$ref": "#/components/schemas/allauth.WebAuthnCredentialCreationOptions"
        },
        "status": {
            "$ref": "#/components/schemas/allauth.StatusOK"
        }
    },
    "required": [
        "status",
        "data"
    ],
    "type": "object"
}

allauth.WebAuthnRequestOptionsResponse

WebAuthn credential request options.

{
    "data": null,
    "status": null
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "properties": {
        "data": {
            "$ref": "#/components/schemas/allauth.WebAuthnCredentialRequestOptions"
        },
        "status": {
            "$ref": "#/components/schemas/allauth.StatusOK"
        }
    },
    "required": [
        "status",
        "data"
    ],
    "type": "object"
}

Common parameters

This section describes common parameters that are reused across operations.

allauth.EmailVerificationKey

Name In Type Default Nullable Description
X-Email-Verification-Key header string No

allauth.PasswordResetKey

Name In Type Default Nullable Description
X-Password-Reset-Key header string No

Security schemes

Name Type Scheme Description
basicAuth http basic
cookieAuth apiKey
oauth2 oauth2
tokenAuth apiKey Token-based authentication with required prefix "Token"

More documentation

More information about InvenTree in the official docs


For more information: https://docs.inventree.org