Skip to content

The CMS
Docs
- Guide
- Reference
- Cookbook
- Quicktips
- Screencasts
- Glossary
- Archive
Resources
- Plugins
- Themes
- Newsletter
- Buzz
- License Hub
Community
Partners

Try
Buy

View all results ›

Formatting text
- KirbyText
- Markdown
Templates
- Field methods
- Helpers
Panel
- Blueprints
- Fields
- Sections
- Blocks
- Icons
- Styling
- Samples
Objects
- $kirby
- $site
- $page
- $pages
- $file
- $files
- $user
- $users
- $block
- $blocks
- $layout
- $layouts
- $language
- $languages
- $pagination
- $request
- $session
- All classes
- Aliases
Router
- Patterns
- Response types
System
- Config options
- Urls
- Roots
- Requirements
- Validators
Plugins
API
- Authentication
- Languages
- Pages
- Roles
- Site
- System
- Translations
- Users
Tools
- A
- Cookie
- Data
- Dir
- Escape
- F
- Header
- Html
- I18n
- Mime
- QrCode
- Query
- Str
- Tpl
- Url
- V
- Xml

new Api()
$api->authenticate()

Runs the authentication method if set
$api->authentication()

Returns the authentication callback
$api->call()

Execute an API call for the given path, request method and optional request data
$api->clone()

Creates a new instance while merging initial and new properties
$api->collection()

Setter and getter for an API collection
$api->collections()

Returns the collections definition
$api->data()

Returns the injected data array or certain parts of it by key
$api->debug()

Returns the debugging flag
$api->fieldApi()
$api->file()

Returns the file object for the given parent path and filename
$api->files()

Returns the all readable files for the parent
$api->hasData()

Checks if injected data exists for the given key
$api->kirby()

Returns the Kirby instance
$api->language()

Returns the language request header
$api->model()

Returns an API model instance by name
$api->models()

Returns all model definitions
$api->page()

Returns the page object for the given id
$api->pages()

Returns the subpages for the given parent. The subpages can be filtered by status (draft, listed, unlisted, published, all)
$api->parent()

Returns the model's object for the given path
$api->render()

Renders the API call
$api->requestBody()

Returns the request body if available
$api->requestData()

Getter for request data Can either get all the data or certain parts of it.
$api->requestFiles()

Returns the files from the request if available
$api->requestHeaders()

Returns all headers from the request if available
$api->requestMethod()

Returns the request method
$api->requestQuery()

Returns the request query if available
$api->resolve()

Turns a Kirby object into an API model or collection representation
$api->responseForException()

Creates the response array for an exception. Kirby exceptions will have more information
$api->responseFor200()

Returns a 200 - ok response array.
$api->responseFor400()

Returns a 400 - bad request response array.
$api->responseFor404()

Returns a 404 - not found response array.
$api->routes()

Returns all defined routes
$api->searchPages()

Search for direct subpages of the given parent
$api->sectionApi()
$api->session()

Returns the current Session instance
$api->site()

Returns the site object
$api->upload()

Upload helper method
$api->user()

Returns the user object for the given id or returns the current authenticated user if no id is passed
$api->users()

Returns the users collection

$api->users()

Returns the users collection

kirby/src/Cms/Api.php#L256

$api->users(): Kirby\Cms\Users

Return type

Kirby\Cms\Users

Parent class

Kirby\Cms\Api

Did you find an error? Help us improve our docs and edit this page on GitHub. Make sure to check out our styleguide

Report an issue on this page on GitHub

Kirby

The CMS that adapts to any project. Made for developers, designers, creators and clients.

🇪🇺 Made in Europe

The CMS
Docs
- Guide
- Reference
- Cookbook
- Quicktips
- Screencasts
- Glossary
- Archive
Resources
- Plugins
- Themes
- Newsletter
- Buzz
- Pixels
- License Hub
Community
Kirby
- Security
- Privacy
- License
- Presskit
- Team
- Contact
With support of