NetBox tenancy API
The tenancy API from NetBox — 12 operation(s) for tenancy.
OpenAPI Specification
openapi: 3.0.3
info:
title: NetBox REST authentication-check tenancy API
version: 4.5.9 (4.5)
license:
name: Apache v2 License
servers:
- url: ''
description: NetBox
tags:
- name: tenancy
paths:
/api/tenancy/contact-assignments/:
get:
operationId: tenancy_contact_assignments_list
description: Get a list of contact assignment objects.
parameters:
- in: query
name: contact_id
schema:
type: array
items:
type: integer
description: Contact (ID)
explode: true
style: form
- in: query
name: contact_id__n
schema:
type: array
items:
type: integer
description: Contact (ID)
explode: true
style: form
- in: query
name: created
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: created__empty
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: created__gt
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: created__gte
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: created__lt
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: created__lte
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: created__n
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: created_by_request
schema:
type: string
format: uuid
- in: query
name: group
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: group__n
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: group_id
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: group_id__n
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: id
schema:
type: array
items:
type: integer
format: int32
explode: true
style: form
- in: query
name: id__empty
schema:
type: boolean
- in: query
name: id__gt
schema:
type: array
items:
type: integer
format: int32
explode: true
style: form
- in: query
name: id__gte
schema:
type: array
items:
type: integer
format: int32
explode: true
style: form
- in: query
name: id__lt
schema:
type: array
items:
type: integer
format: int32
explode: true
style: form
- in: query
name: id__lte
schema:
type: array
items:
type: integer
format: int32
explode: true
style: form
- in: query
name: id__n
schema:
type: array
items:
type: integer
format: int32
explode: true
style: form
- in: query
name: last_updated
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: last_updated__empty
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: last_updated__gt
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: last_updated__gte
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: last_updated__lt
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: last_updated__lte
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: last_updated__n
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- name: limit
required: false
in: query
description: Number of results to return per page.
schema:
type: integer
- in: query
name: modified_by_request
schema:
type: string
format: uuid
- in: query
name: object_id
schema:
type: array
items:
type: integer
format: int32
explode: true
style: form
- in: query
name: object_id__empty
schema:
type: boolean
- in: query
name: object_id__gt
schema:
type: array
items:
type: integer
format: int32
explode: true
style: form
- in: query
name: object_id__gte
schema:
type: array
items:
type: integer
format: int32
explode: true
style: form
- in: query
name: object_id__lt
schema:
type: array
items:
type: integer
format: int32
explode: true
style: form
- in: query
name: object_id__lte
schema:
type: array
items:
type: integer
format: int32
explode: true
style: form
- in: query
name: object_id__n
schema:
type: array
items:
type: integer
format: int32
explode: true
style: form
- in: query
name: object_type
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: object_type__n
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: object_type_id
schema:
type: integer
- in: query
name: object_type_id__n
schema:
type: integer
- name: offset
required: false
in: query
description: The initial index from which to return the results.
schema:
type: integer
- name: ordering
required: false
in: query
description: Which field to use when ordering the results.
schema:
type: string
- in: query
name: priority
schema:
type: string
x-spec-enum-id: 0548fc537440bf9d
nullable: true
enum:
- inactive
- 'null'
- primary
- secondary
- tertiary
description: '* `primary` - Primary
* `secondary` - Secondary
* `tertiary` - Tertiary
* `inactive` - Inactive'
- in: query
name: priority__empty
schema:
type: boolean
- in: query
name: priority__ic
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: priority__ie
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: priority__iew
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: priority__iregex
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: priority__isw
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: priority__n
schema:
type: string
x-spec-enum-id: 0548fc537440bf9d
nullable: true
enum:
- inactive
- 'null'
- primary
- secondary
- tertiary
description: '* `primary` - Primary
* `secondary` - Secondary
* `tertiary` - Tertiary
* `inactive` - Inactive'
- in: query
name: priority__nic
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: priority__nie
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: priority__niew
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: priority__nisw
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: priority__regex
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: q
schema:
type: string
description: Search
- in: query
name: role
schema:
type: array
items:
type: string
description: Contact role (slug)
explode: true
style: form
- in: query
name: role__n
schema:
type: array
items:
type: string
description: Contact role (slug)
explode: true
style: form
- in: query
name: role_id
schema:
type: array
items:
type: integer
description: Contact role (ID)
explode: true
style: form
- in: query
name: role_id__n
schema:
type: array
items:
type: integer
description: Contact role (ID)
explode: true
style: form
- in: query
name: tag
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: tag__n
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: tag_id
schema:
type: array
items:
type: integer
explode: true
style: form
- in: query
name: tag_id__n
schema:
type: array
items:
type: integer
explode: true
style: form
- in: query
name: updated_by_request
schema:
type: string
format: uuid
tags:
- tenancy
security:
- cookieAuth: []
- tokenAuth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedContactAssignmentList'
description: ''
post:
operationId: tenancy_contact_assignments_create
description: Post a list of contact assignment objects.
tags:
- tenancy
requestBody:
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/WritableContactAssignmentRequest'
- type: array
items:
$ref: '#/components/schemas/WritableContactAssignmentRequest'
multipart/form-data:
schema:
oneOf:
- $ref: '#/components/schemas/WritableContactAssignmentRequest'
- type: array
items:
$ref: '#/components/schemas/WritableContactAssignmentRequest'
required: true
security:
- cookieAuth: []
- tokenAuth: []
responses:
'201':
content:
application/json:
schema:
$ref: '#/components/schemas/ContactAssignment'
description: ''
put:
operationId: tenancy_contact_assignments_bulk_update
description: Put a list of contact assignment objects.
tags:
- tenancy
requestBody:
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ContactAssignmentRequest'
multipart/form-data:
schema:
type: array
items:
$ref: '#/components/schemas/ContactAssignmentRequest'
required: true
security:
- cookieAuth: []
- tokenAuth: []
responses:
'200':
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ContactAssignment'
description: ''
patch:
operationId: tenancy_contact_assignments_bulk_partial_update
description: Patch a list of contact assignment objects.
tags:
- tenancy
requestBody:
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ContactAssignmentRequest'
multipart/form-data:
schema:
type: array
items:
$ref: '#/components/schemas/ContactAssignmentRequest'
required: true
security:
- cookieAuth: []
- tokenAuth: []
responses:
'200':
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ContactAssignment'
description: ''
delete:
operationId: tenancy_contact_assignments_bulk_destroy
description: Delete a list of contact assignment objects.
tags:
- tenancy
requestBody:
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ContactAssignmentRequest'
multipart/form-data:
schema:
type: array
items:
$ref: '#/components/schemas/ContactAssignmentRequest'
required: true
security:
- cookieAuth: []
- tokenAuth: []
responses:
'204':
description: No response body
/api/tenancy/contact-assignments/{id}/:
get:
operationId: tenancy_contact_assignments_retrieve
description: Get a contact assignment object.
parameters:
- in: path
name: id
schema:
type: integer
description: A unique integer value identifying this contact assignment.
required: true
tags:
- tenancy
security:
- cookieAuth: []
- tokenAuth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ContactAssignment'
description: ''
put:
operationId: tenancy_contact_assignments_update
description: Put a contact assignment object.
parameters:
- in: path
name: id
schema:
type: integer
description: A unique integer value identifying this contact assignment.
required: true
tags:
- tenancy
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/WritableContactAssignmentRequest'
multipart/form-data:
schema:
$ref: '#/components/schemas/WritableContactAssignmentRequest'
required: true
security:
- cookieAuth: []
- tokenAuth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ContactAssignment'
description: ''
patch:
operationId: tenancy_contact_assignments_partial_update
description: Patch a contact assignment object.
parameters:
- in: path
name: id
schema:
type: integer
description: A unique integer value identifying this contact assignment.
required: true
tags:
- tenancy
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PatchedWritableContactAssignmentRequest'
multipart/form-data:
schema:
$ref: '#/components/schemas/PatchedWritableContactAssignmentRequest'
security:
- cookieAuth: []
- tokenAuth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ContactAssignment'
description: ''
delete:
operationId: tenancy_contact_assignments_destroy
description: Delete a contact assignment object.
parameters:
- in: path
name: id
schema:
type: integer
description: A unique integer value identifying this contact assignment.
required: true
tags:
- tenancy
security:
- cookieAuth: []
- tokenAuth: []
responses:
'204':
description: No response body
/api/tenancy/contact-groups/:
get:
operationId: tenancy_contact_groups_list
description: Get a list of contact group objects.
parameters:
- in: query
name: ancestor
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: ancestor__n
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: ancestor_id
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: ancestor_id__n
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: contact_id
schema:
type: array
items:
type: integer
description: Contact (ID)
explode: true
style: form
- in: query
name: contact_id__n
schema:
type: array
items:
type: integer
description: Contact (ID)
explode: true
style: form
- in: query
name: created
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: created__empty
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: created__gt
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: created__gte
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: created__lt
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: created__lte
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: created__n
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: created_by_request
schema:
type: string
format: uuid
- in: query
name: description
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: description__empty
schema:
type: boolean
- in: query
name: description__ic
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: description__ie
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: description__iew
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: description__iregex
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: description__isw
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: description__n
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: description__nic
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: description__nie
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: description__niew
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: description__nisw
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: description__regex
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: id
schema:
type: array
items:
type: integer
format: int32
explode: true
style: form
- in: query
name: id__empty
schema:
type: boolean
- in: query
name: id__gt
schema:
type: array
items:
type: integer
format: int32
explode: true
style: form
- in: query
name: id__gte
schema:
type: array
items:
type: integer
format: int32
explode: true
style: form
- in: query
name: id__lt
schema:
type: array
items:
type: integer
format: int32
explode: true
style: form
- in: query
name: id__lte
schema:
type: array
items:
type: integer
format: int32
explode: true
style: form
- in: query
name: id__n
schema:
type: array
items:
type: integer
format: int32
explode: true
style: form
- in: query
name: last_updated
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: last_updated__empty
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: last_updated__gt
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: last_updated__gte
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: last_updated__lt
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: last_updated__lte
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- in: query
name: last_updated__n
schema:
type: array
items:
type: string
format: date-time
explode: true
style: form
- name: limit
required: false
in: query
description: Number of results to return per page.
schema:
type: integer
- in: query
name: modified_by_request
schema:
type: string
format: uuid
- in: query
name: name
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: name__empty
schema:
type: boolean
- in: query
name: name__ic
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: name__ie
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: name__iew
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: name__iregex
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: name__isw
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: name__n
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: name__nic
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: name__nie
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: name__niew
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: name__nisw
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: name__regex
schema:
type: array
items:
type: string
explode: true
style: form
- name: offset
required: false
in: query
description: The initial index from which to return the results.
schema:
type: integer
- name: ordering
required: false
in: query
description: Which field to use when ordering the results.
schema:
type: string
- in: query
name: owner
schema:
type: array
items:
type: string
description: Owner (name)
explode: true
style: form
- in: query
name: owner__n
schema:
type: array
items:
type: string
description: Owner (name)
explode: true
style: form
- in: query
name: owner_group
schema:
type: array
items:
type: string
description: Owner Group (name)
explode: true
style: form
- in: query
name: owner_group__n
schema:
type: array
items:
type: string
description: Owner Group (name)
explode: true
style: form
- in: query
name: owner_group_id
schema:
type: array
items:
type: integer
description: Owner Group (ID)
explode: true
style: form
- in: query
name: owner_group_id__n
schema:
type: array
items:
type: integer
description: Owner Group (ID)
explode: true
style: form
- in: query
name: owner_id
schema:
type: array
items:
type: integer
nullable: true
description: Owner (ID)
explode: true
style: form
- in: query
name: owner_id__n
schema:
type: array
items:
type: integer
nullable: true
description: Owner (ID)
explode: true
style: form
- in: query
name: parent
schema:
type: array
items:
type: string
description: Parent contact group (slug)
explode: true
style: form
- in: query
name: parent__n
schema:
type: array
items:
type: string
description: Parent contact group (slug)
explode: true
style: form
- in: query
name: parent_id
schema:
type: array
items:
type: integer
nullable: true
description: Parent contact group (ID)
explode: true
style: form
- in: query
name: parent_id__n
schema:
type: array
items:
type: integer
nullable: true
description: Parent contact group (ID)
explode: true
style: form
- in: query
name: q
schema:
type: string
description: Search
- in: query
name: slug
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: slug__empty
schema:
type: boolean
- in: query
name: slug__ic
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: slug__ie
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: slug__iew
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: slug__iregex
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
name: slug__isw
schema:
type: array
items:
type: string
explode: true
style: form
- in: query
# --- truncated at 32 KB (169 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/netbox/refs/heads/main/openapi/netbox-tenancy-api-openapi.yml